Commercial Operations
Check a project quote against a margin floor — Notion review blocks
Return integer-minor-unit cost, profit, margin in basis points and a review/pass decision for a quote. Do not set prices or issue a quote. Prepare a Notion review blocks.
Experimental native example · local preview · revision 1
WORKFLOW PREVIEW
See how it works
Use + and − to zoom, F to fit. Press Enter on a node to inspect it.
Private preview. These tested drafts are available for inspection. Adding them to a Vora workspace is still being tested.
What you need
- Authorized supplied job facts matching the original closed input contract.
- Explicit review metadata and target destination fields; no implicit team, channel, list or project selection.
Follow the workflow step by step
Supplied agency job and review metadata
Receive the explicitly supplied manual input packet.
Check a project quote against a margin floor
Return integer-minor-unit cost, profit, margin in basis points and a review/pass decision for a quote. Do not set prices or issue a quote.
- default: Notion review blocks
Notion review blocks
Return integer-minor-unit cost, profit, margin in basis points and a review/pass decision for a quote. Do not set prices or issue a quote.
Setup and review
- Download the workflow JSON and inspect its jobInput and deliveryMetadata contracts.
- Supply the original agency job input plus explicit review metadata and destination.
- Run in an isolated test and inspect the complete jobResult, target status, holds and escape report before taking an external action.
Inspect every node
Expand a node to inspect its complete settings. Review the runtime and adoption evidence before installing it.
Supplied agency job and review metadata · wfManualTrigger
{
"label": "Supplied agency job and review metadata"
}Check a project quote against a margin floor · code
{
"label": "Check a project quote against a margin floor",
"code": "return (function(context){\n\nfunction obj(value, keys, required = keys) {\n if (!value || typeof value !== 'object' || Array.isArray(value)) throw new Error('Expected object');\n if (Object.keys(value).some(key => !keys.includes(key))) throw new Error('Unknown input field');\n if (required.some(key => !Object.hasOwn(value, key))) throw new Error('Missing required input field');\n return value;\n}\nfunction text(value, name, max = 200, allowEmpty = false) {\n if (typeof value !== 'string' || value.length > max || (!allowEmpty && !value.trim())) throw new Error('Invalid ' + name);\n return value.trim();\n}\nfunction list(value, name, max = 500) {\n if (!Array.isArray(value) || value.length > max) throw new Error('Invalid ' + name);\n return value;\n}\nfunction int(value, name, min = 0, max = Number.MAX_SAFE_INTEGER) {\n if (!Number.isSafeInteger(value) || value < min || value > max) throw new Error('Invalid ' + name);\n return value;\n}\nfunction amount(value, name) {\n if (!Number.isFinite(value) || value < 0 || value > 1000000000) throw new Error('Invalid ' + name);\n return value;\n}\nfunction email(value) { return /^[^\\s@]+@[^\\s@]+\\.[^\\s@]+$/.test(value); }\nfunction day(value) {\n if (typeof value !== 'string' || !/^\\d{4}-\\d{2}-\\d{2}$/.test(value)) throw new Error('Invalid calendar date');\n const ms = Date.parse(value + 'T00:00:00Z');\n if (!Number.isFinite(ms) || new Date(ms).toISOString().slice(0, 10) !== value) throw new Error('Invalid calendar date');\n return ms;\n}\nfunction instant(value) {\n if (typeof value !== 'string' || !/^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d{3})?Z$/.test(value)) throw new Error('Invalid UTC timestamp');\n const ms = Date.parse(value);\n const normalized = value.includes('.') ? value : value.replace('Z', '.000Z');\n if (!Number.isFinite(ms) || new Date(ms).toISOString() !== normalized) throw new Error('Invalid UTC timestamp');\n return ms;\n}\nfunction uniqueIds(items) {\n const ids = items.map(item => text(item.id, 'item ID', 120));\n if (new Set(ids).size !== ids.length) throw new Error('Duplicate item ID');\n return ids;\n}\nfunction ratioBps(numerator, denominator) {\n const n = BigInt(numerator) * 10000n;\n const d = BigInt(denominator);\n const quotient = n / d;\n const floor = n < 0n && n % d !== 0n ? quotient - 1n : quotient;\n const result = Number(floor);\n if (!Number.isSafeInteger(result)) throw new Error('Unsafe calculated ratio');\n return result;\n}\n\n\nconst x = obj(context.input, ['quoteId','currency','feeMinor','costItems','minimumMarginBps']);\nconst quoteId = text(x.quoteId, 'quote ID', 120);\nif (typeof x.currency !== 'string' || !/^[A-Z]{3}$/.test(x.currency)) throw new Error('Invalid currency');\nconst feeMinor = int(x.feeMinor, 'fee minor units', 1);\nconst minimum = int(x.minimumMarginBps, 'minimum margin', 0, 10000);\nconst costs = list(x.costItems, 'cost items', 100);\ncosts.forEach(item => obj(item, ['id','amountMinor']));\nuniqueIds(costs);\nlet totalCostMinor = 0;\nfor (const item of costs) { totalCostMinor += int(item.amountMinor, 'cost minor units'); int(totalCostMinor, 'total cost'); }\nconst profitMinor = feeMinor - totalCostMinor;\nconst marginBps = ratioBps(profitMinor, feeMinor);\nreturn {quoteId, currency:x.currency, totalCostMinor, profitMinor, marginBps, decision:marginBps >= minimum ? 'pass' : 'review'};\n\n})({input:context.input.jobInput});\n",
"outputVar": "jobResult",
"timeout": 3000,
"memoryLimit": 64
}Notion review blocks · code
{
"label": "Notion review blocks",
"code": "const jobResult=context.jobResult;\nconst delivery=(function(context){\nreturn ((function(originalResult,metadata,destination){\nfunction stableResult(value,depth=0){\n if(depth>64)throw new Error('Result nesting exceeds 64');\n if(value===null||typeof value==='string'||typeof value==='boolean')return JSON.stringify(value);\n if(typeof value==='number'&&Number.isFinite(value))return JSON.stringify(value);\n if(Array.isArray(value)){\n if(Object.keys(value).length!==value.length||Array.from({length:value.length},(_,i)=>i).some(i=>!Object.hasOwn(value,i)))throw new Error('Result contains sparse data');\n return '['+value.map(item=>stableResult(item,depth+1)).join(',')+']';\n }\n if(value&&typeof value==='object')return '{'+Object.keys(value).sort().map(key=>JSON.stringify(key)+':'+stableResult(value[key],depth+1)).join(',')+'}';\n throw new Error('Result is not JSON data');\n}\nfunction utf8Length(text){\n let bytes=0;\n for(let i=0;i<text.length;i++){\n const code=text.charCodeAt(i);\n if(code<128)bytes++;else if(code<2048)bytes+=2;\n else if(code>=55296&&code<=56319&&i+1<text.length&&text.charCodeAt(i+1)>=56320&&text.charCodeAt(i+1)<=57343){bytes+=4;i++;}\n else bytes+=3;\n }\n return bytes;\n}\nfunction chunkText(text,maximum){\n const chunks=[];\n for(let start=0;start<text.length;){let end=Math.min(start+maximum,text.length);const last=text.charCodeAt(end-1),next=text.charCodeAt(end);if(end<text.length&&last>=55296&&last<=56319&&next>=56320&&next<=57343)end--;chunks.push(text.slice(start,end));start=end;}\n return chunks;\n}\nfunction deliveryState(rendererId,originalResult,metadata,destination,destinationKeys){\n const output={rendererId,status:'HELD',originalResult,drafts:[],holds:[],escapeReport:[]};\n const hold=(code,message)=>{output.holds.push({code,message});return {output,json:''};};\n const object=value=>value&&typeof value==='object'&&!Array.isArray(value);\n const exact=(value,keys)=>object(value)&&Object.keys(value).length===keys.length&&keys.every(key=>Object.hasOwn(value,key));\n const keys=['workflowId','canonicalIntentId','title','reviewUrl'],maxima=[128,200,200,1000];\n if(!exact(metadata,keys)||keys.some((key,i)=>typeof metadata[key]!=='string'||!metadata[key].length||metadata[key].length>maxima[i]||/[\\u0000-\\u001f\\u007f]/.test(metadata[key]))||!/^https?:\\/\\/[^\\s<>\"']+$/.test(metadata.reviewUrl))return hold('INVALID_METADATA','Metadata must provide bounded workflowId, canonicalIntentId, title and an HTTP(S) reviewUrl.');\n if(!exact(destination,destinationKeys)||destinationKeys.some(key=>typeof destination[key]!=='string'||!destination[key].length||destination[key].length>200||destination[key]!==destination[key].trim()||/[\\u0000-\\u001f\\u007f]/.test(destination[key])))return hold('INVALID_DESTINATION','Destination fields must be exactly: '+destinationKeys.join(', ')+'.');\n let json;\n try{if(!object(originalResult))throw new Error('Primary result must be a JSON object');json=stableResult(originalResult);}catch(error){return hold('INVALID_RESULT',error.message);}\n if(json.length>32768||utf8Length(json)>65536)return hold('RESULT_BOUND_EXCEEDED','Original result exceeds this renderer profile; full original result is retained.');\n return {output,json};\n}\nfunction escapeHtml(text){return text.replace(/&/g,'&').replace(/</g,'<').replace(/>/g,'>').replace(/\"/g,'"').replace(/'/g,''');}\nfunction escapeMarkdown(text){return text.replace(/&/g,'&').replace(/[\\\\`*{}\\[\\]()#+\\-.!_|>~<]/g,'\\\\$&');}\nfunction markdownReviewText(metadata,json){\n const runs=json.match(/`+/g)||[],fence='`'.repeat(Math.max(3,...runs.map(run=>run.length+1)));\n return '# '+escapeMarkdown(metadata.title)+'\\n\\nWorkflow: '+escapeMarkdown(metadata.workflowId)+'\\nCanonical job: '+escapeMarkdown(metadata.canonicalIntentId)+'\\nReview: <'+metadata.reviewUrl.replace(/&/g,'&')+'>\\n\\n'+fence+'json\\n'+json+'\\n'+fence+'\\n';\n}\nfunction plainReviewText(metadata,json){return metadata.title+'\\nWorkflow: '+metadata.workflowId+'\\nCanonical job: '+metadata.canonicalIntentId+'\\nReview: '+metadata.reviewUrl+'\\n\\n'+json;}\nfunction finishDraft(state,draft,texts=[],textMaximum=32768,byteMaximum=131072){\n if(texts.some(text=>text.length>textMaximum)||utf8Length(JSON.stringify(draft))>byteMaximum){state.output.holds.push({code:'TARGET_BOUND_EXCEEDED',message:'Draft exceeds the target or Vora profile bound; no draft is emitted and the full original result is retained.'});return state.output;}\n state.output.status='PREPARED';state.output.drafts=[draft];return state.output;\n}\nreturn (function notionBlocksReview(originalResult,metadata,destination){\n const state=deliveryState('notion-blocks-review',originalResult,metadata,destination,['blockId']);if(state.output.holds.length)return state.output;\n const texts=[metadata.title,'Workflow: '+metadata.workflowId+'\\nCanonical job: '+metadata.canonicalIntentId,'Review: '+metadata.reviewUrl,...chunkText(state.json,2000)];\n const children=texts.map(content=>({object:'block',type:'paragraph',paragraph:{rich_text:[{type:'text',text:{content}}]}}));\n if(children.length>100){state.output.holds.push({code:'TARGET_BOUND_EXCEEDED',message:'Notion draft exceeds the documented block-array limit; no draft is emitted.'});return state.output;}\n return finishDraft(state,{blockId:destination.blockId,body:{children}},texts,2000);\n})(originalResult,metadata,destination);\n}))(context.input.jobResult,context.input.deliveryMetadata.metadata,context.input.deliveryMetadata.destination);\n\n})({input:{jobResult,deliveryMetadata:context.input.deliveryMetadata}});\nreturn {jobResult,delivery};\n",
"outputVar": "result",
"timeout": 3000,
"memoryLimit": 64
}Input and output contracts
Input
{
"type": "object",
"properties": {
"jobInput": {
"additionalProperties": false,
"properties": {
"costItems": {
"items": {
"additionalProperties": false,
"properties": {
"amountMinor": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"id": {
"maxLength": 120,
"type": "string"
}
},
"required": [
"id",
"amountMinor"
],
"type": "object"
},
"maxItems": 100,
"type": "array"
},
"currency": {
"maxLength": 3,
"type": "string"
},
"feeMinor": {
"maximum": 9007199254740991,
"minimum": 1,
"type": "integer"
},
"minimumMarginBps": {
"maximum": 10000,
"minimum": 0,
"type": "integer"
},
"quoteId": {
"maxLength": 120,
"type": "string"
}
},
"required": [
"quoteId",
"currency",
"feeMinor",
"costItems",
"minimumMarginBps"
],
"type": "object"
},
"deliveryMetadata": {
"type": "object",
"properties": {
"metadata": {
"type": "object",
"properties": {
"workflowId": {
"type": "string",
"maxLength": 128
},
"canonicalIntentId": {
"type": "string",
"maxLength": 200
},
"title": {
"type": "string",
"maxLength": 200
},
"reviewUrl": {
"type": "string",
"maxLength": 1000
}
},
"required": [
"workflowId",
"canonicalIntentId",
"title",
"reviewUrl"
],
"additionalProperties": false
},
"destination": {
"type": "object",
"properties": {
"blockId": {
"type": "string",
"maxLength": 200
}
},
"required": [
"blockId"
],
"additionalProperties": false
}
},
"required": [
"metadata",
"destination"
],
"additionalProperties": false
}
},
"required": [
"jobInput",
"deliveryMetadata"
],
"additionalProperties": false
}Output
{
"type": "object",
"properties": {
"jobResult": {
"additionalProperties": false,
"properties": {
"currency": {
"maxLength": 3,
"type": "string"
},
"decision": {
"maxLength": 20,
"type": "string"
},
"marginBps": {
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"profitMinor": {
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"quoteId": {
"maxLength": 120,
"type": "string"
},
"totalCostMinor": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
}
},
"required": [
"quoteId",
"currency",
"totalCostMinor",
"profitMinor",
"marginBps",
"decision"
],
"type": "object"
},
"delivery": {
"type": "object",
"properties": {
"rendererId": {
"type": "string",
"maxLength": 128,
"enum": [
"notion-blocks-review"
]
},
"status": {
"type": "string",
"maxLength": 16,
"enum": [
"PREPARED",
"HELD"
]
},
"originalResult": {
"additionalProperties": false,
"properties": {
"currency": {
"maxLength": 3,
"type": "string"
},
"decision": {
"maxLength": 20,
"type": "string"
},
"marginBps": {
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"profitMinor": {
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"quoteId": {
"maxLength": 120,
"type": "string"
},
"totalCostMinor": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
}
},
"required": [
"quoteId",
"currency",
"totalCostMinor",
"profitMinor",
"marginBps",
"decision"
],
"type": "object"
},
"drafts": {
"type": "array",
"items": {
"type": "object",
"properties": {
"blockId": {
"type": "string",
"maxLength": 200
},
"body": {
"type": "object",
"properties": {
"children": {
"type": "array",
"items": {
"type": "object",
"properties": {
"object": {
"type": "string",
"maxLength": 16,
"enum": [
"block"
]
},
"type": {
"type": "string",
"maxLength": 16,
"enum": [
"paragraph"
]
},
"paragraph": {
"type": "object",
"properties": {
"rich_text": {
"type": "array",
"items": {
"type": "object",
"properties": {
"type": {
"type": "string",
"maxLength": 16,
"enum": [
"text"
]
},
"text": {
"type": "object",
"properties": {
"content": {
"type": "string",
"maxLength": 2000
}
},
"required": [
"content"
],
"additionalProperties": false
}
},
"required": [
"type",
"text"
],
"additionalProperties": false
},
"maxItems": 1,
"minItems": 1
}
},
"required": [
"rich_text"
],
"additionalProperties": false
}
},
"required": [
"object",
"type",
"paragraph"
],
"additionalProperties": false
},
"maxItems": 100,
"minItems": 4
}
},
"required": [
"children"
],
"additionalProperties": false
}
},
"required": [
"blockId",
"body"
],
"additionalProperties": false
},
"maxItems": 1,
"minItems": 0
},
"holds": {
"type": "array",
"items": {
"type": "object",
"properties": {
"code": {
"type": "string",
"maxLength": 128
},
"message": {
"type": "string",
"maxLength": 2000
}
},
"required": [
"code",
"message"
],
"additionalProperties": false
},
"maxItems": 10,
"minItems": 0
},
"escapeReport": {
"type": "array",
"items": {
"type": "object",
"properties": {
"field": {
"type": "string",
"maxLength": 256
},
"method": {
"type": "string",
"maxLength": 80
},
"originalValue": {
"type": "string",
"maxLength": 32768
},
"escapedValue": {
"type": "string",
"maxLength": 32768
}
},
"required": [
"field",
"method",
"originalValue",
"escapedValue"
],
"additionalProperties": false
},
"maxItems": 1000,
"minItems": 0
}
},
"required": [
"rendererId",
"status",
"originalResult",
"drafts",
"holds",
"escapeReport"
],
"additionalProperties": false
}
},
"required": [
"jobResult",
"delivery"
],
"additionalProperties": false
}Related implementations
Compare implementations for this job · Primary business workflow
Caller supplies blockId; children are literal paragraph blocks using rich_text text.content, without Markdown parsing. First three paragraphs contain metadata; subsequent paragraphs contain the complete stable JSON split at 2000 UTF-16 units without dividing a surrogate pair. Joining all result paragraphs in order recovers the entire stable JSON. Original result, including original reasons/holds, is preserved without mutation. Missing/extra destination fields or invalid metadata hold the draft. No truncation: overflow returns HELD with an empty drafts array and full original result.
Supplied input: vora-agency-quote-margin-check · 1. Draft/result: notion-blocks-review · Notion REST append-block-children / paragraph review profile v1.
Mapping and loss rules
- Caller supplies blockId; children are literal paragraph blocks using rich_text text.content, without Markdown parsing.
- First three paragraphs contain metadata; subsequent paragraphs contain the complete stable JSON split at 2000 UTF-16 units without dividing a surrogate pair.
- Joining all result paragraphs in order recovers the entire stable JSON.
- Original result, including original reasons/holds, is preserved without mutation.
- Missing/extra destination fields or invalid metadata hold the draft.
- No truncation: overflow returns HELD with an empty drafts array and full original result.
This binding consumes supplied data. It does not establish an authenticated connector or a provider write.
Example input and result
These examples use synthetic data.
Input
{
"jobInput": {
"quoteId": "quote-01",
"currency": "EUR",
"feeMinor": 100000,
"costItems": [
{
"id": "delivery",
"amountMinor": 50000
},
{
"id": "tools",
"amountMinor": 10000
}
],
"minimumMarginBps": 3000
},
"deliveryMetadata": {
"metadata": {
"workflowId": "agency-quote-margin-check",
"canonicalIntentId": "commercial.evaluate-quote-margin",
"title": "Check a project quote against a margin floor",
"reviewUrl": "https://example.test/workflows/quote-margin-check/"
},
"destination": {
"blockId": "00000000-0000-4000-8000-000000000001"
}
}
}Expected result
{
"jobResult": {
"quoteId": "quote-01",
"currency": "EUR",
"totalCostMinor": 60000,
"profitMinor": 40000,
"marginBps": 4000,
"decision": "pass"
},
"delivery": {
"rendererId": "notion-blocks-review",
"status": "PREPARED",
"originalResult": {
"quoteId": "quote-01",
"currency": "EUR",
"totalCostMinor": 60000,
"profitMinor": 40000,
"marginBps": 4000,
"decision": "pass"
},
"drafts": [
{
"blockId": "00000000-0000-4000-8000-000000000001",
"body": {
"children": [
{
"object": "block",
"type": "paragraph",
"paragraph": {
"rich_text": [
{
"type": "text",
"text": {
"content": "Check a project quote against a margin floor"
}
}
]
}
},
{
"object": "block",
"type": "paragraph",
"paragraph": {
"rich_text": [
{
"type": "text",
"text": {
"content": "Workflow: agency-quote-margin-check\nCanonical job: commercial.evaluate-quote-margin"
}
}
]
}
},
{
"object": "block",
"type": "paragraph",
"paragraph": {
"rich_text": [
{
"type": "text",
"text": {
"content": "Review: https://example.test/workflows/quote-margin-check/"
}
}
]
}
},
{
"object": "block",
"type": "paragraph",
"paragraph": {
"rich_text": [
{
"type": "text",
"text": {
"content": "{\"currency\":\"EUR\",\"decision\":\"pass\",\"marginBps\":4000,\"profitMinor\":40000,\"quoteId\":\"quote-01\",\"totalCostMinor\":60000}"
}
}
]
}
}
]
}
}
],
"holds": [],
"escapeReport": []
}
}Success means: Return integer-minor-unit cost, profit, margin in basis points and a review/pass decision for a quote. Do not set prices or issue a quote.
When something goes wrong
- Review original business holds and target holds separately. Correct the relevant supplied input and rerun without discarding the original job result.
Limits and costs
- This prepares a target-specific review draft from the original agency decision. The complete original job result and business holds remain visible. A held target produces no draft. No provider request, send, import, issue creation or publication occurs.
- No paid model calls or metered third-party operations are declared in this pure graph. Vora plan availability, compute and quotas still apply; pricing has not been verified by this batch.