@ainetwork/adk 0.4.1 → 0.5.1

package/dist/esm/services/user-workflow.service.d.ts

@@ -0,0 +1,24 @@
+import { UserWorkflow } from '../types/memory.js';
+import { MemoryModule } from '../modules/memory/memory.module.js';
+import { WorkflowVariableResolver } from './workflow-variable-resolver.service.js';
+import '../modules/memory/base.memory.js';
+
+/**
+ * Service for persisting user workflows.
+ *
+ * Keeps storage-focused operations in one place while delegating variable resolution
+ * and execution orchestration to dedicated collaborators.
+ */
+declare class UserWorkflowService {
+    private memoryModule;
+    private workflowVariableResolver;
+    constructor(memoryModule: MemoryModule, workflowVariableResolver: WorkflowVariableResolver);
+    createWorkflow(workflow: UserWorkflow): Promise<UserWorkflow>;
+    updateWorkflow(workflowId: string, updates: Partial<UserWorkflow>): Promise<void>;
+    deleteWorkflow(workflowId: string, userId: string): Promise<void>;
+    getWorkflow(workflowId: string): Promise<UserWorkflow | undefined>;
+    listWorkflows(userId?: string): Promise<UserWorkflow[]>;
+    listActiveScheduledWorkflows(): Promise<UserWorkflow[]>;
+}
+
+export { UserWorkflowService };

package/dist/esm/services/user-workflow.service.js

@@ -0,0 +1,7 @@
+import {
+  UserWorkflowService
+} from "../chunk-2PPPWQ2H.js";
+export {
+  UserWorkflowService
+};
+//# sourceMappingURL=user-workflow.service.js.map

package/dist/esm/services/user-workflow.service.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/esm/services/workflow-execution.service.d.ts

@@ -0,0 +1,34 @@
+import { QueryService } from './query.service.js';
+import { UserWorkflowService } from './user-workflow.service.js';
+import { WorkflowVariableResolver } from './workflow-variable-resolver.service.js';
+import '../types/stream.js';
+import '../types/memory.js';
+import '../types/connector.js';
+import '../modules/memory/memory.module.js';
+import '../modules/memory/base.memory.js';
+import '../modules/models/base.model.js';
+import '../modules/models/model.module.js';
+import './intents/fulfill.service.js';
+import '../modules/a2a/a2a.module.js';
+import '@a2a-js/sdk';
+import '../modules/mcp/mcp.module.js';
+import '../types/mcp.js';
+import '@modelcontextprotocol/sdk/client/sse.js';
+import '@modelcontextprotocol/sdk/client/stdio.js';
+import '@modelcontextprotocol/sdk/client/streamableHttp.js';
+import '../types/agent.js';
+import 'http-status-codes';
+import './pii.service.js';
+import './intents/trigger.service.js';
+
+declare class WorkflowExecutionService {
+    private userWorkflowService;
+    private queryService;
+    private workflowVariableResolver;
+    constructor(userWorkflowService: UserWorkflowService, queryService: QueryService, workflowVariableResolver: WorkflowVariableResolver);
+    executeWorkflow(workflowId: string, executionVariables?: Record<string, string>): Promise<{
+        threadId?: string;
+    }>;
+}
+
+export { WorkflowExecutionService };

package/dist/esm/services/workflow-execution.service.js

@@ -0,0 +1,9 @@
+import {
+  WorkflowExecutionService
+} from "../chunk-3R44BIY3.js";
+import "../chunk-P4J6U5PZ.js";
+import "../chunk-GHUEA7V5.js";
+export {
+  WorkflowExecutionService
+};
+//# sourceMappingURL=workflow-execution.service.js.map

package/dist/esm/services/workflow-execution.service.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/esm/services/workflow-variable-resolver.service.d.ts

@@ -0,0 +1,15 @@
+import { UserWorkflow } from '../types/memory.js';
+
+type WorkflowTextFields = Pick<UserWorkflow, "title" | "content" | "timezone" | "variables" | "variableValues">;
+declare class WorkflowVariableResolver {
+    resolveForCreation(workflow: WorkflowTextFields): {
+        content: string;
+        title: string;
+    };
+    resolveForExecution(workflow: WorkflowTextFields, executionVariables?: Record<string, string>): {
+        query: string;
+        displayQuery: string;
+    };
+}
+
+export { WorkflowVariableResolver };

package/dist/esm/services/workflow-variable-resolver.service.js

@@ -0,0 +1,8 @@
+import {
+  WorkflowVariableResolver
+} from "../chunk-GOXUKMWE.js";
+import "../chunk-WTQJZ6G3.js";
+export {
+  WorkflowVariableResolver
+};
+//# sourceMappingURL=workflow-variable-resolver.service.js.map

package/dist/esm/services/workflow-variable-resolver.service.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/esm/types/memory.d.ts

@@ -53,12 +53,22 @@ declare enum ThreadType {
     WORKFLOW = "WORKFLOW",
     CHAT = "CHAT"
 }
+type ThreadFilter = {
+    /** Filter by user workflow ID */
+    workflowId?: string;
+    /** Filter by thread type */
+    type?: ThreadType;
+};
 type ThreadMetadata = {
     type: ThreadType;
     title: string;
     userId: string;
     threadId: string;
     isPinned?: boolean;
+    /** ID of the user workflow that created this thread */
+    workflowId?: string;
+    createdAt?: string;
+    updatedAt?: string;
 };
 /**
  * Represents a conversation thread containing multiple messages.
@@ -83,8 +93,11 @@ type ThreadObject = {
     type: ThreadType;
     title: string;
     isPinned?: boolean;
+    /** ID of the user workflow that created this thread */
+    workflowId?: string;
     messages: Array<MessageObject>;
 };
+type IntentToolChoice = "auto" | "required";
 interface Intent {
     id: string;
     name: string;
@@ -93,6 +106,11 @@ interface Intent {
     prompt?: string;
     triggeringSentences?: Array<string>;
     tags?: Array<string>;
+    /** Controls whether the LLM must call a tool for this intent.
+     * - "required": first LLM call must invoke at least one tool
+     * - "auto": LLM decides (default)
+     */
+    toolChoice?: IntentToolChoice;
 }
 type TriggeredIntent = {
     subquery: string;
@@ -123,21 +141,67 @@ type FulfillmentResult = {
     /** Response text generated for this intent */
     response: string;
 };
-type WorkflowVariableType = "select" | "date_range" | "text" | "number";
+type WorkflowVariableType = "select" | "date_range" | "date_parts" | "text" | "number";
+type WorkflowVariableResolveAt = "creation" | "execution";
 interface WorkflowVariable {
     id: string;
     label: string;
     type: WorkflowVariableType;
     options?: Array<string>;
+    /** When to resolve this variable:
+     * - "creation": resolved when copying template → my workflow (e.g., store selection)
+     * - "execution": resolved each time the workflow runs (e.g., date range)
+     * Defaults to "creation" if not specified.
+     */
+    resolveAt?: WorkflowVariableResolveAt;
 }
-interface Workflow {
-    workflowId: string;
-    userId?: string;
+/**
+ * A workflow template — an immutable blueprint for creating user workflows.
+ * System-provided or admin-defined.
+ */
+interface WorkflowTemplate {
+    templateId: string;
     title: string;
     description: string;
     active: boolean;
+    /** The prompt/instruction template with {{variable}} placeholders */
+    content: string;
+    /** Variable schema definitions (type, label, options) for UI rendering */
+    variables?: Record<string, WorkflowVariable>;
+}
+/**
+ * A user-owned workflow instance, optionally created from a WorkflowTemplate.
+ *
+ * Supports:
+ * - Internal execution via scheduler/service
+ * - Scheduled execution via cron expression
+ * - Template variables (e.g., {{today}}, {{yesterday}}) resolved at execution time
+ * - User-defined variable values resolved at execution time
+ */
+interface UserWorkflow {
+    workflowId: string;
+    userId: string;
+    title: string;
+    description?: string;
+    active: boolean;
+    /** Reference to the original WorkflowTemplate (optional) */
+    templateId?: string;
+    /** The prompt/instruction content with {{variable}} placeholders */
     content: string;
+    /** Variable schema definitions (copied from template, used for UI rendering) */
     variables?: Record<string, WorkflowVariable>;
+    /** User-provided variable values (can contain template variables like {{today}}) */
+    variableValues?: Record<string, string>;
+    /** Cron expression for scheduled execution (e.g., "0 9 * * *"). If not set, manual-only. */
+    schedule?: string;
+    /** IANA timezone (e.g., "Asia/Seoul"). Defaults to system timezone. */
+    timezone?: string;
+    /** Unix timestamp of the last execution */
+    lastRunAt?: number;
+    /** Unix timestamp of the next scheduled execution */
+    nextRunAt?: number;
+    /** Thread ID of the last execution result */
+    lastThreadId?: string;
 }
 
-export { type FulfillmentResult, type Intent, type IntentTriggerResult, type MessageContentObject, type MessageObject, MessageRole, type ThreadMetadata, type ThreadObject, ThreadType, type TriggeredIntent, type Workflow, type WorkflowVariable, type WorkflowVariableType };
+export { type FulfillmentResult, type Intent, type IntentToolChoice, type IntentTriggerResult, type MessageContentObject, type MessageObject, MessageRole, type ThreadFilter, type ThreadMetadata, type ThreadObject, ThreadType, type TriggeredIntent, type UserWorkflow, type WorkflowTemplate, type WorkflowVariable, type WorkflowVariableResolveAt, type WorkflowVariableType };

package/dist/esm/types/memory.js

@@ -1,7 +1,7 @@
 import {
   MessageRole,
   ThreadType
-} from "../chunk-B4LJ37RT.js";
+} from "../chunk-P4J6U5PZ.js";
 export {
   MessageRole,
   ThreadType

package/dist/esm/utils/template-variables.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Template variable resolver for scheduled jobs.
+ *
+ * Resolves `{{...}}` patterns in strings to actual values at execution time.
+ * Supports date-based variables with optional format and offset.
+ *
+ * Built-in variables:
+ * - {{today}}, {{yesterday}}, {{tomorrow}}
+ * - {{today+N}}, {{today-N}} (day offset)
+ * - {{year}}, {{month}}, {{day}}
+ * - {{year+N}}, {{year-N}}, {{month+N}}, {{month-N}}, {{day+N}}, {{day-N}}
+ * - {{startOfWeek}}, {{endOfWeek}}
+ * - {{startOfMonth}}, {{endOfMonth}}
+ * - {{now}} (datetime)
+ *
+ * Format override: {{today|YYYY/MM/DD}}
+ */
+/**
+ * Resolves all template variables in a string.
+ *
+ * @example
+ * resolveTemplateString("{{yesterday}} 매출 분석", "Asia/Seoul")
+ * // → "2026-03-30 매출 분석"
+ */
+declare function resolveTemplateString(template: string, timezone?: string): string;
+/**
+ * Resolves all template variables in a record of string values.
+ *
+ * @example
+ * resolveTemplateRecord({ date: "{{today}}", range: "{{startOfMonth}}~{{today}}" }, "Asia/Seoul")
+ * // → { date: "2026-03-31", range: "2026-03-01~2026-03-31" }
+ */
+declare function resolveTemplateRecord(record: Record<string, string>, timezone?: string): Record<string, string>;
+
+export { resolveTemplateRecord, resolveTemplateString };

package/dist/esm/utils/template-variables.js

@@ -0,0 +1,9 @@
+import {
+  resolveTemplateRecord,
+  resolveTemplateString
+} from "../chunk-WTQJZ6G3.js";
+export {
+  resolveTemplateRecord,
+  resolveTemplateString
+};
+//# sourceMappingURL=template-variables.js.map

package/dist/esm/utils/template-variables.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@ainetwork/adk",
-	"version": "0.4.1",
+	"version": "0.5.1",
 	"description": "AI Network Agent Development Kit",
 	"repository": "git@github.com:ainetwork-ai/ain-adk.git",
 	"author": "AI Network (https://ainetwork.ai)",
@@ -77,6 +77,7 @@
 		"dotenv": "^16.5.0",
 		"express": "^5.1.0",
 		"http-status-codes": "^2.3.0",
+		"node-cron": "^4.2.1",
 		"uuid": "^11.1.0",
 		"winston": "^3.17.0",
 		"winston-daily-rotate-file": "^5.0.0"

package/dist/cjs/chunk-22H5DEV4.cjs

@@ -1,29 +0,0 @@
-"use strict";Object.defineProperty(exports, "__esModule", {value: true});
-
-var _chunk2KGEFVQ2cjs = require('./chunk-2KGEFVQ2.cjs');
-
-
-var _chunkGA6NTHXBcjs = require('./chunk-GA6NTHXB.cjs');
-
-
-var _chunkXFTYFPPQcjs = require('./chunk-XFTYFPPQ.cjs');
-
-// src/routes/a2a.routes.ts
-var _server = require('@a2a-js/sdk/server');
-var _express = require('express');
-var createA2ARouter = () => {
-  const router = _express.Router.call(void 0, );
-  const taskStore = new (0, _server.InMemoryTaskStore)();
-  const a2aController = new (0, _chunk2KGEFVQ2cjs.A2AController)(
-    _chunkXFTYFPPQcjs.container.getA2AService(),
-    taskStore,
-    _chunkGA6NTHXBcjs.getAgent.call(void 0, ).generateAgentCard
-  );
-  router.post("/", a2aController.handleA2ARequest);
-  return router;
-};
-
-
-
-exports.createA2ARouter = createA2ARouter;
-//# sourceMappingURL=chunk-22H5DEV4.cjs.map

package/dist/cjs/chunk-22H5DEV4.cjs.map

@@ -1 +0,0 @@
-{"version":3,"sources":["/Users/shyun/comcom/ain-agent/ain-adk/dist/cjs/chunk-22H5DEV4.cjs","../../src/routes/a2a.routes.ts"],"names":[],"mappings":"AAAA;AACE;AACF,wDAA6B;AAC7B;AACE;AACF,wDAA6B;AAC7B;AACE;AACF,wDAA6B;AAC7B;AACA;ACVA,4CAAkC;AAClC,kCAAuB;AAWhB,IAAM,gBAAA,EAAkB,CAAA,EAAA,GAAc;AAC5C,EAAA,MAAM,OAAA,EAAS,6BAAA,CAAO;AAGtB,EAAA,MAAM,UAAA,EAAY,IAAI,8BAAA,CAAkB,CAAA;AACxC,EAAA,MAAM,cAAA,EAAgB,IAAI,oCAAA;AAAA,IACzB,2BAAA,CAAU,aAAA,CAAc,CAAA;AAAA,IACxB,SAAA;AAAA,IACA,wCAAA,CAAS,CAAE;AAAA,EACZ,CAAA;AAEA,EAAA,MAAA,CAAO,IAAA,CAAK,GAAA,EAAK,aAAA,CAAc,gBAAgB,CAAA;AAE/C,EAAA,OAAO,MAAA;AACR,CAAA;ADFA;AACA;AACE;AACF,0CAAC","file":"/Users/shyun/comcom/ain-agent/ain-adk/dist/cjs/chunk-22H5DEV4.cjs","sourcesContent":[null,"import { InMemoryTaskStore } from \"@a2a-js/sdk/server\";\nimport { Router } from \"express\";\nimport { getAgent } from \"@/config/agent\";\nimport { container } from \"@/container\";\nimport { A2AController } from \"../controllers/a2a.controller.js\";\n\n/**\n * Creates and configures the A2A router.\n * This function is a \"composition root\" for the A2A feature,\n * creating and injecting all necessary dependencies.\n * @returns An Express Router instance.\n */\nexport const createA2ARouter = (): Router => {\n\tconst router = Router();\n\n\t// TaskStore is stateful and needs fresh instance per router\n\tconst taskStore = new InMemoryTaskStore();\n\tconst a2aController = new A2AController(\n\t\tcontainer.getA2AService(),\n\t\ttaskStore,\n\t\tgetAgent().generateAgentCard,\n\t);\n\n\trouter.post(\"/\", a2aController.handleA2ARequest);\n\n\treturn router;\n};\n"]}