@output.ai/core 0.1.12 → 0.1.14

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@output.ai/core",
-  "version": "0.1.12",
+  "version": "0.1.14",
   "description": "The core module of the output framework",
   "type": "module",
   "exports": {

package/src/index.d.ts

@@ -24,13 +24,25 @@ type AnyZodSchema = z.ZodType<any, any, any>;
  * Activity options accepted by step/evaluator/workflow definitions.
  * Exposes supported Temporal ActivityOptions.
  *
- * @typedef {object} Options
  * @description Exposes supported Temporal ActivityOptions
  */
 export type Options = Omit<ActivityOptions, 'versioningIntent' | 'taskQueue' | 'allowEagerDispatch'>;
 
+/**
+ * The last argument when calling workflows is used to configure it
+ */
 export type WorkflowCallConfig = {
-  options?: Options
+
+  /**
+   * Temporal Activity Options
+   */
+  options?: Options,
+
+  /**
+   * Whether this workflow will run detached or not.
+   * Detached workflows called without explicitly awaiting for the result will be "fire-an-forget", outliving the parent.
+   */
+  detached?: boolean
 };
 
 /*

package/src/interface/webhook.js

@@ -1,5 +1,5 @@
 // THIS RUNS IN THE TEMPORAL'S SANDBOX ENVIRONMENT
-import { defineSignal, setHandler, proxyActivities, workflowInfo, proxySinks } from '@temporalio/workflow';
+import { defineSignal, setHandler, proxyActivities, workflowInfo, proxySinks, uuid4 } from '@temporalio/workflow';
 import { ACTIVITY_SEND_WEBHOOK } from '#consts';
 import { FatalError } from '#errors';
 import { validateCreateWebhook } from './validations/static.js';
@@ -20,7 +20,7 @@ export async function createWebhook( { url, payload } ) {
   const sinks = await proxySinks();
   const resumeSignal = defineSignal( 'resume' );
 
-  const traceId = `${workflowId}-${url}-${Date.now()}`;
+  const traceId = `${workflowId}-${url}-${uuid4}`;
   sinks.trace.addEventStart( { id: traceId, name: 'resume', kind: 'webhook' } );
   return new Promise( resolve =>
     setHandler( resumeSignal, responsePayload => {

package/src/interface/workflow.js

@@ -1,5 +1,5 @@
 // THIS RUNS IN THE TEMPORAL'S SANDBOX ENVIRONMENT
-import { proxyActivities, inWorkflowContext, executeChild, workflowInfo } from '@temporalio/workflow';
+import { proxyActivities, inWorkflowContext, executeChild, workflowInfo, uuid4, ParentClosePolicy } from '@temporalio/workflow';
 import { validateWorkflow } from './validations/static.js';
 import { validateWithSchema } from './validations/runtime.js';
 import { SHARED_STEP_PREFIX, ACTIVITY_GET_TRACE_DESTINATIONS } from '#consts';
@@ -59,18 +59,28 @@ export function workflow( { name, description, inputSchema, outputSchema, fn, op
       invokeSharedStep: async ( stepName, input, options ) => steps[`${SHARED_STEP_PREFIX}#${stepName}`]( input, options ),
       invokeEvaluator: async ( evaluatorName, input, options ) => steps[`${workflowPath}#${evaluatorName}`]( input, options ),
 
-      startWorkflow: async ( childName, input, extra = {} ) => {
-        return executeChild( childName, {
+      /**
+       * Start a child workflow
+       *
+       * @param {string} childName
+       * @param {unknown} input
+       * @param {object} extra
+       * @param {boolean} extra.detached
+       * @param {import('@temporalio/workflow').ActivityOptions} extra.options
+       * @returns
+       */
+      startWorkflow: async ( childName, input, extra = {} ) =>
+        executeChild( childName, {
           args: input ? [ input ] : [],
-          workflowId: `${workflowId}-${childName}-${Date.now()}`,
+          workflowId: `${workflowId}-${childName}-${uuid4()}`,
+          parentClosePolicy: ParentClosePolicy[extra?.detached ? 'ABANDON' : 'TERMINATE'],
           memo: {
             executionContext,
             parentId: workflowId,
             // new configuration for activities of the child workflow, this will be omitted so it will use what that workflow have defined
             ...( extra?.options && { activityOptions: mergeActivityOptions( activityOptions, extra.options ) } )
           }
-        } );
-      }
+        } )
     }, input );
 
     validateWithSchema( outputSchema, output, `Workflow ${name} output` );