@graph-compose/core 1.0.0

package/dist/types/contracts/agents.d.ts

@@ -0,0 +1,87 @@
+import { z } from "zod";
+/**
+ * This is the response that the agent must use in order to use a tool.
+ */
+export declare const AgentToolUsageSchema: z.ZodObject<{
+    /** Indicates this is a tool usage action */
+    type: z.ZodLiteral<"tool">;
+    /** ID of the tool to use */
+    toolId: z.ZodString;
+    /** Configuration for the tool execution */
+    toolPayload: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+}, "strip", z.ZodTypeAny, {
+    type: "tool";
+    toolId: string;
+    toolPayload: Record<string, unknown>;
+}, {
+    type: "tool";
+    toolId: string;
+    toolPayload: Record<string, unknown>;
+}>;
+/**
+ * This is the response that an agent must send in order to end the current agent flow.
+ */
+export declare const AgentCompletionResponseSchema: z.ZodObject<{
+    /** Indicates this is the final action */
+    type: z.ZodLiteral<"complete">;
+    /** Final output from the agent */
+    final_result: z.ZodAny;
+}, "strip", z.ZodTypeAny, {
+    type: "complete";
+    final_result?: any;
+}, {
+    type: "complete";
+    final_result?: any;
+}>;
+export declare const AgentResponseSchema: z.ZodObject<{
+    /** The next action the agent wants to take */
+    next_action: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
+        /** Indicates this is a tool usage action */
+        type: z.ZodLiteral<"tool">;
+        /** ID of the tool to use */
+        toolId: z.ZodString;
+        /** Configuration for the tool execution */
+        toolPayload: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    }, "strip", z.ZodTypeAny, {
+        type: "tool";
+        toolId: string;
+        toolPayload: Record<string, unknown>;
+    }, {
+        type: "tool";
+        toolId: string;
+        toolPayload: Record<string, unknown>;
+    }>, z.ZodObject<{
+        /** Indicates this is the final action */
+        type: z.ZodLiteral<"complete">;
+        /** Final output from the agent */
+        final_result: z.ZodAny;
+    }, "strip", z.ZodTypeAny, {
+        type: "complete";
+        final_result?: any;
+    }, {
+        type: "complete";
+        final_result?: any;
+    }>]>;
+}, "strip", z.ZodTypeAny, {
+    next_action: {
+        type: "tool";
+        toolId: string;
+        toolPayload: Record<string, unknown>;
+    } | {
+        type: "complete";
+        final_result?: any;
+    };
+}, {
+    next_action: {
+        type: "tool";
+        toolId: string;
+        toolPayload: Record<string, unknown>;
+    } | {
+        type: "complete";
+        final_result?: any;
+    };
+}>;
+export type AgentToolUsageResponse = z.infer<typeof AgentToolUsageSchema>;
+export type AgentCompletionResponse = z.infer<typeof AgentCompletionResponseSchema>;
+export type AgentResponse = z.infer<typeof AgentResponseSchema>;
+//# sourceMappingURL=agents.d.ts.map

package/dist/types/contracts/agents.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agents.d.ts","sourceRoot":"","sources":["../../../src/types/contracts/agents.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;GAEG;AACH,eAAO,MAAM,oBAAoB;IAE7B,4CAA4C;;IAK5C,4BAA4B;;IAK5B,2CAA2C;;;;;;;;;;EAqB3C,CAAC;AAEL;;GAEG;AACH,eAAO,MAAM,6BAA6B;IAEtC,yCAAyC;;IAMzC,kCAAkC;;;;;;;;EAoBlC,CAAC;AAEL,eAAO,MAAM,mBAAmB;IAE5B,8CAA8C;;QApE9C,4CAA4C;;QAK5C,4BAA4B;;QAK5B,2CAA2C;;;;;;;;;;;QA4B3C,yCAAyC;;QAMzC,kCAAkC;;;;;;;;;;;;;;;;;;;;;;;;;;;EA2ClC,CAAC;AAGL,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAC1E,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAC3C,OAAO,6BAA6B,CACrC,CAAC;AACF,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC"}

package/dist/types/contracts/agents.js

@@ -0,0 +1,94 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AgentResponseSchema = exports.AgentCompletionResponseSchema = exports.AgentToolUsageSchema = void 0;
+const zod_1 = require("zod");
+/**
+ * This is the response that the agent must use in order to use a tool.
+ */
+exports.AgentToolUsageSchema = zod_1.z
+    .object({
+    /** Indicates this is a tool usage action */
+    type: zod_1.z.literal("tool").openapi({
+        description: "Indicates this is a tool usage action",
+        example: "tool",
+    }),
+    /** ID of the tool to use */
+    toolId: zod_1.z.string().openapi({
+        description: "The ID of the tool to use",
+        example: "search",
+    }),
+    /** Configuration for the tool execution */
+    toolPayload: zod_1.z.record(zod_1.z.unknown()).openapi({
+        description: "This information will be added to the tool payload and sent to the tool API",
+        example: {
+            query: "Latest AI frameworks in 2024",
+            filters: { date: "2024", category: "machine learning" },
+        },
+    }),
+})
+    .openapi({
+    title: "Agent Tool Usage",
+    description: "Agent wants to use a tool to gather more information",
+    example: {
+        type: "tool",
+        toolId: "search",
+        toolPayload: {
+            query: "Latest AI frameworks in 2024",
+            filters: { date: "2024", category: "machine learning" },
+        },
+    },
+});
+/**
+ * This is the response that an agent must send in order to end the current agent flow.
+ */
+exports.AgentCompletionResponseSchema = zod_1.z
+    .object({
+    /** Indicates this is the final action */
+    type: zod_1.z.literal("complete").openapi({
+        description: "Indicates this is the final action, and the workflow can continue to other nodes",
+        example: "complete",
+    }),
+    /** Final output from the agent */
+    final_result: zod_1.z.any().openapi({
+        description: "The final output from the agent",
+        example: {
+            recommendation: "PyTorch 2.0 shows significant improvements...",
+            confidence: 0.95,
+        },
+    }),
+})
+    .openapi({
+    title: "Agent Completion",
+    description: "Agent has completed its task and is returning final results",
+    example: {
+        type: "complete",
+        final_result: {
+            recommendation: "PyTorch 2.0 shows significant improvements...",
+            confidence: 0.95,
+        },
+    },
+    "x-tags": ["Agents"],
+});
+exports.AgentResponseSchema = zod_1.z
+    .object({
+    /** The next action the agent wants to take */
+    next_action: zod_1.z.discriminatedUnion("type", [
+        exports.AgentToolUsageSchema,
+        exports.AgentCompletionResponseSchema,
+    ]),
+})
+    .openapi({
+    title: "Agent Response",
+    description: "Response from an agent indicating what it wants to do next",
+    example: {
+        next_action: {
+            type: "tool",
+            toolId: "search",
+            toolPayload: {
+                query: "Latest AI frameworks in 2024",
+                filters: { date: "2024" },
+            },
+        },
+    },
+});
+//# sourceMappingURL=agents.js.map

package/dist/types/contracts/agents.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agents.js","sourceRoot":"","sources":["../../../src/types/contracts/agents.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AAExB;;GAEG;AACU,QAAA,oBAAoB,GAAG,OAAC;KAClC,MAAM,CAAC;IACN,4CAA4C;IAC5C,IAAI,EAAE,OAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC;QAC9B,WAAW,EAAE,uCAAuC;QACpD,OAAO,EAAE,MAAM;KAChB,CAAC;IACF,4BAA4B;IAC5B,MAAM,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC;QACzB,WAAW,EAAE,2BAA2B;QACxC,OAAO,EAAE,QAAQ;KAClB,CAAC;IACF,2CAA2C;IAC3C,WAAW,EAAE,OAAC,CAAC,MAAM,CAAC,OAAC,CAAC,OAAO,EAAE,CAAC,CAAC,OAAO,CAAC;QACzC,WAAW,EACT,6EAA6E;QAC/E,OAAO,EAAE;YACP,KAAK,EAAE,8BAA8B;YACrC,OAAO,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,kBAAkB,EAAE;SACxD;KACF,CAAC;CACH,CAAC;KACD,OAAO,CAAC;IACP,KAAK,EAAE,kBAAkB;IACzB,WAAW,EAAE,sDAAsD;IACnE,OAAO,EAAE;QACP,IAAI,EAAE,MAAM;QACZ,MAAM,EAAE,QAAQ;QAChB,WAAW,EAAE;YACX,KAAK,EAAE,8BAA8B;YACrC,OAAO,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,kBAAkB,EAAE;SACxD;KACF;CACF,CAAC,CAAC;AAEL;;GAEG;AACU,QAAA,6BAA6B,GAAG,OAAC;KAC3C,MAAM,CAAC;IACN,yCAAyC;IACzC,IAAI,EAAE,OAAC,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,OAAO,CAAC;QAClC,WAAW,EACT,kFAAkF;QACpF,OAAO,EAAE,UAAU;KACpB,CAAC;IACF,kCAAkC;IAClC,YAAY,EAAE,OAAC,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC;QAC5B,WAAW,EAAE,iCAAiC;QAC9C,OAAO,EAAE;YACP,cAAc,EAAE,+CAA+C;YAC/D,UAAU,EAAE,IAAI;SACjB;KACF,CAAC;CACH,CAAC;KACD,OAAO,CAAC;IACP,KAAK,EAAE,kBAAkB;IACzB,WAAW,EAAE,6DAA6D;IAC1E,OAAO,EAAE;QACP,IAAI,EAAE,UAAU;QAChB,YAAY,EAAE;YACZ,cAAc,EAAE,+CAA+C;YAC/D,UAAU,EAAE,IAAI;SACjB;KACF;IACD,QAAQ,EAAE,CAAC,QAAQ,CAAC;CACrB,CAAC,CAAC;AAEQ,QAAA,mBAAmB,GAAG,OAAC;KACjC,MAAM,CAAC;IACN,8CAA8C;IAC9C,WAAW,EAAE,OAAC,CAAC,kBAAkB,CAAC,MAAM,EAAE;QACxC,4BAAoB;QACpB,qCAA6B;KAC9B,CAAC;CACH,CAAC;KACD,OAAO,CAAC;IACP,KAAK,EAAE,gBAAgB;IACvB,WAAW,EAAE,4DAA4D;IACzE,OAAO,EAAE;QACP,WAAW,EAAE;YACX,IAAI,EAAE,MAAM;YACZ,MAAM,EAAE,QAAQ;YAChB,WAAW,EAAE;gBACX,KAAK,EAAE,8BAA8B;gBACrC,OAAO,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE;aAC1B;SACF;KACF;CACF,CAAC,CAAC"}

package/dist/types/contracts/index.d.ts

@@ -0,0 +1,3 @@
+export * from "./agents";
+export * from "./tools";
+//# sourceMappingURL=index.d.ts.map

package/dist/types/contracts/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/types/contracts/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,SAAS,CAAC"}

package/dist/types/contracts/index.js

@@ -0,0 +1,19 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./agents"), exports);
+__exportStar(require("./tools"), exports);
+//# sourceMappingURL=index.js.map

package/dist/types/contracts/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/types/contracts/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,2CAAyB;AACzB,0CAAwB"}

package/dist/types/contracts/tools.d.ts

@@ -0,0 +1,72 @@
+import { z } from "zod";
+/**
+ * Error information returned from a tool execution
+ * Note: This is the expected structure in the response body, not the HTTP response itself.
+ * When implementing a tool API:
+ * 1. Set the appropriate HTTP status code (e.g., res.status(429))
+ * 2. Return this error structure in the response body
+ */
+export declare const ToolErrorSchema: z.ZodObject<{
+    /** HTTP status code or custom error code */
+    code: z.ZodNumber;
+    /** Human readable error message */
+    message: z.ZodString;
+    /** Optional detailed error context */
+    details: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, "strip", z.ZodTypeAny, {
+    code: number;
+    message: string;
+    details?: Record<string, unknown> | undefined;
+}, {
+    code: number;
+    message: string;
+    details?: Record<string, unknown> | undefined;
+}>;
+/**
+ * Response payload returned from a tool
+ * Note: For error cases:
+ * 1. Set the appropriate HTTP status code (e.g., res.status(429))
+ * 2. Return { success: false, error: { code: 429, message: "...", details: {...} } }
+ */
+export declare const ToolHttpResponseSchema: z.ZodObject<{
+    /** Whether the tool execution was successful */
+    success: z.ZodBoolean;
+    /** The result data from the tool if successful */
+    result: z.ZodOptional<z.ZodUnknown>;
+    /** Error information if the tool execution failed */
+    error: z.ZodOptional<z.ZodObject<{
+        /** HTTP status code or custom error code */
+        code: z.ZodNumber;
+        /** Human readable error message */
+        message: z.ZodString;
+        /** Optional detailed error context */
+        details: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, "strip", z.ZodTypeAny, {
+        code: number;
+        message: string;
+        details?: Record<string, unknown> | undefined;
+    }, {
+        code: number;
+        message: string;
+        details?: Record<string, unknown> | undefined;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    success: boolean;
+    result?: unknown;
+    error?: {
+        code: number;
+        message: string;
+        details?: Record<string, unknown> | undefined;
+    } | undefined;
+}, {
+    success: boolean;
+    result?: unknown;
+    error?: {
+        code: number;
+        message: string;
+        details?: Record<string, unknown> | undefined;
+    } | undefined;
+}>;
+export type ToolHttpResponse = z.infer<typeof ToolHttpResponseSchema>;
+export type ToolError = z.infer<typeof ToolErrorSchema>;
+//# sourceMappingURL=tools.d.ts.map

package/dist/types/contracts/tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../../src/types/contracts/tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;;GAMG;AACH,eAAO,MAAM,eAAe;IAExB,4CAA4C;;IAM5C,mCAAmC;;IAKnC,sCAAsC;;;;;;;;;;EA4BtC,CAAC;AAEL;;;;;GAKG;AACH,eAAO,MAAM,sBAAsB;IACjC,gDAAgD;;IAMhD,kDAAkD;;IAmClD,qDAAqD;;QAzFnD,4CAA4C;;QAM5C,mCAAmC;;QAKnC,sCAAsC;;;;;;;;;;;;;;;;;;;;;;;;;;;EAmFxC,CAAC;AAGH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AACtE,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC"}

package/dist/types/contracts/tools.js

@@ -0,0 +1,101 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ToolHttpResponseSchema = exports.ToolErrorSchema = void 0;
+const zod_1 = require("zod");
+/**
+ * Error information returned from a tool execution
+ * Note: This is the expected structure in the response body, not the HTTP response itself.
+ * When implementing a tool API:
+ * 1. Set the appropriate HTTP status code (e.g., res.status(429))
+ * 2. Return this error structure in the response body
+ */
+exports.ToolErrorSchema = zod_1.z
+    .object({
+    /** HTTP status code or custom error code */
+    code: zod_1.z.number().openapi({
+        description: "Error code (should match the HTTP status code when applicable)",
+        example: 429,
+    }),
+    /** Human readable error message */
+    message: zod_1.z.string().openapi({
+        description: "Human readable error message",
+        example: "Rate limit exceeded - try again in 60 seconds",
+    }),
+    /** Optional detailed error context */
+    details: zod_1.z
+        .record(zod_1.z.unknown())
+        .optional()
+        .openapi({
+        description: "Additional error context that may be helpful for the agent or future user of this data.",
+        example: {
+            retry_after: 60,
+            rate_limit: {
+                limit: 100,
+                remaining: 0,
+                reset: 1709544060000,
+            },
+        },
+    }),
+})
+    .openapi({
+    title: "Tool Error",
+    description: "Error information returned in the response body when a tool execution fails. Note: This should be returned along with the appropriate HTTP status code.",
+    example: {
+        code: 429,
+        message: "Rate limit exceeded",
+        details: {
+            retry_after: 60,
+        },
+    },
+});
+/**
+ * Response payload returned from a tool
+ * Note: For error cases:
+ * 1. Set the appropriate HTTP status code (e.g., res.status(429))
+ * 2. Return { success: false, error: { code: 429, message: "...", details: {...} } }
+ */
+exports.ToolHttpResponseSchema = zod_1.z.object({
+    /** Whether the tool execution was successful */
+    success: zod_1.z.boolean().openapi({
+        description: "Indicates if the tool executed successfully. For HTTP errors, this should be false and the error field should be populated",
+        example: true,
+    }),
+    /** The result data from the tool if successful */
+    result: zod_1.z
+        .unknown()
+        .optional()
+        .openapi({
+        example: {
+            query: "Latest developments in AI",
+            results: [
+                {
+                    title: "GPT-4 Turbo Released with Enhanced Capabilities",
+                    snippet: "OpenAI announces GPT-4 Turbo with improved context handling and specialized domain knowledge",
+                    url: "https://example.com/gpt4-turbo-release",
+                    date: "2024-03-01",
+                    source: "AI News Weekly",
+                },
+                {
+                    title: "Breakthrough in Computer Vision Models",
+                    snippet: "Researchers achieve new state-of-the-art performance in object detection with 98% accuracy",
+                    url: "https://example.com/vision-breakthrough",
+                    date: "2024-02-28",
+                    source: "Tech Research Journal",
+                },
+            ],
+            metadata: {
+                total_results: 156,
+                search_time_ms: 234,
+                filters_applied: {
+                    date_range: "past_month",
+                    sort: "relevance",
+                },
+            },
+        },
+    }),
+    /** Error information if the tool execution failed */
+    error: exports.ToolErrorSchema.optional().openapi({
+        description: "Error information (required if success is false). Should match the HTTP status code when applicable.",
+    }),
+});
+//# sourceMappingURL=tools.js.map

package/dist/types/contracts/tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.js","sourceRoot":"","sources":["../../../src/types/contracts/tools.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AAExB;;;;;;GAMG;AACU,QAAA,eAAe,GAAG,OAAC;KAC7B,MAAM,CAAC;IACN,4CAA4C;IAC5C,IAAI,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC;QACvB,WAAW,EACT,gEAAgE;QAClE,OAAO,EAAE,GAAG;KACb,CAAC;IACF,mCAAmC;IACnC,OAAO,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC;QAC1B,WAAW,EAAE,8BAA8B;QAC3C,OAAO,EAAE,+CAA+C;KACzD,CAAC;IACF,sCAAsC;IACtC,OAAO,EAAE,OAAC;SACP,MAAM,CAAC,OAAC,CAAC,OAAO,EAAE,CAAC;SACnB,QAAQ,EAAE;SACV,OAAO,CAAC;QACP,WAAW,EACT,yFAAyF;QAC3F,OAAO,EAAE;YACP,WAAW,EAAE,EAAE;YACf,UAAU,EAAE;gBACV,KAAK,EAAE,GAAG;gBACV,SAAS,EAAE,CAAC;gBACZ,KAAK,EAAE,aAAa;aACrB;SACF;KACF,CAAC;CACL,CAAC;KACD,OAAO,CAAC;IACP,KAAK,EAAE,YAAY;IACnB,WAAW,EACT,yJAAyJ;IAC3J,OAAO,EAAE;QACP,IAAI,EAAE,GAAG;QACT,OAAO,EAAE,qBAAqB;QAC9B,OAAO,EAAE;YACP,WAAW,EAAE,EAAE;SAChB;KACF;CACF,CAAC,CAAC;AAEL;;;;;GAKG;AACU,QAAA,sBAAsB,GAAG,OAAC,CAAC,MAAM,CAAC;IAC7C,gDAAgD;IAChD,OAAO,EAAE,OAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC;QAC3B,WAAW,EACT,4HAA4H;QAC9H,OAAO,EAAE,IAAI;KACd,CAAC;IACF,kDAAkD;IAClD,MAAM,EAAE,OAAC;SACN,OAAO,EAAE;SACT,QAAQ,EAAE;SACV,OAAO,CAAC;QACP,OAAO,EAAE;YACP,KAAK,EAAE,2BAA2B;YAClC,OAAO,EAAE;gBACP;oBACE,KAAK,EAAE,iDAAiD;oBACxD,OAAO,EACL,8FAA8F;oBAChG,GAAG,EAAE,wCAAwC;oBAC7C,IAAI,EAAE,YAAY;oBAClB,MAAM,EAAE,gBAAgB;iBACzB;gBACD;oBACE,KAAK,EAAE,wCAAwC;oBAC/C,OAAO,EACL,4FAA4F;oBAC9F,GAAG,EAAE,yCAAyC;oBAC9C,IAAI,EAAE,YAAY;oBAClB,MAAM,EAAE,uBAAuB;iBAChC;aACF;YACD,QAAQ,EAAE;gBACR,aAAa,EAAE,GAAG;gBAClB,cAAc,EAAE,GAAG;gBACnB,eAAe,EAAE;oBACf,UAAU,EAAE,YAAY;oBACxB,IAAI,EAAE,WAAW;iBAClB;aACF;SACF;KACF,CAAC;IACJ,qDAAqD;IACrD,KAAK,EAAE,uBAAe,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC;QACxC,WAAW,EACT,sGAAsG;KACzG,CAAC;CACH,CAAC,CAAC"}

package/dist/types/index.d.ts

@@ -0,0 +1,10 @@
+export * from "./behaviors";
+export * from "./config";
+export * from "./context";
+export * from "./contracts";
+export * from "./nodes";
+export * from "./primitives";
+export * from "./results";
+export * from "./state";
+export * from "./workflow";
+//# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,UAAU,CAAC;AACzB,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC;AAC5B,cAAc,SAAS,CAAC;AACxB,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC;AAC1B,cAAc,SAAS,CAAC;AACxB,cAAc,YAAY,CAAC"}

package/dist/types/index.js

@@ -0,0 +1,26 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./behaviors"), exports);
+__exportStar(require("./config"), exports);
+__exportStar(require("./context"), exports);
+__exportStar(require("./contracts"), exports);
+__exportStar(require("./nodes"), exports);
+__exportStar(require("./primitives"), exports);
+__exportStar(require("./results"), exports);
+__exportStar(require("./state"), exports);
+__exportStar(require("./workflow"), exports);
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,8CAA4B;AAC5B,2CAAyB;AACzB,4CAA0B;AAC1B,8CAA4B;AAC5B,0CAAwB;AACxB,+CAA6B;AAC7B,4CAA0B;AAC1B,0CAAwB;AACxB,6CAA2B"}

package/dist/types/nodes/agents.d.ts

@@ -0,0 +1,149 @@
+import { z } from "zod";
+export declare const AgentNodeSchema: z.ZodObject<{
+    id: z.ZodString;
+    iterationContext: z.ZodOptional<z.ZodObject<{
+        originalNodeId: z.ZodString;
+        iteratorNodeId: z.ZodString;
+        index: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        originalNodeId: string;
+        iteratorNodeId: string;
+        index: number;
+    }, {
+        originalNodeId: string;
+        iteratorNodeId: string;
+        index: number;
+    }>>;
+    activityConfig: z.ZodOptional<z.ZodObject<{
+        retryPolicy: z.ZodOptional<z.ZodObject<{
+            backoffCoefficient: z.ZodOptional<z.ZodOptional<z.ZodNumber>>;
+            initialInterval: z.ZodOptional<z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>>;
+            maximumAttempts: z.ZodOptional<z.ZodOptional<z.ZodNumber>>;
+            maximumInterval: z.ZodOptional<z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>>;
+        }, "strip", z.ZodTypeAny, {
+            backoffCoefficient?: number | undefined;
+            initialInterval?: string | undefined;
+            maximumAttempts?: number | undefined;
+            maximumInterval?: string | undefined;
+        }, {
+            backoffCoefficient?: number | undefined;
+            initialInterval?: string | undefined;
+            maximumAttempts?: number | undefined;
+            maximumInterval?: string | undefined;
+        }>>;
+        startToCloseTimeout: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
+        scheduleToCloseTimeout: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
+    }, "strip", z.ZodTypeAny, {
+        retryPolicy?: {
+            backoffCoefficient?: number | undefined;
+            initialInterval?: string | undefined;
+            maximumAttempts?: number | undefined;
+            maximumInterval?: string | undefined;
+        } | undefined;
+        startToCloseTimeout?: string | undefined;
+        scheduleToCloseTimeout?: string | undefined;
+    }, {
+        retryPolicy?: {
+            backoffCoefficient?: number | undefined;
+            initialInterval?: string | undefined;
+            maximumAttempts?: number | undefined;
+            maximumInterval?: string | undefined;
+        } | undefined;
+        startToCloseTimeout?: string | undefined;
+        scheduleToCloseTimeout?: string | undefined;
+    }>>;
+} & {
+    type: z.ZodLiteral<"agent">;
+    http: z.ZodObject<{
+        method: z.ZodEnum<["GET", "POST", "PUT", "DELETE", "PATCH", "HEAD", "OPTIONS"]>;
+        url: z.ZodEffects<z.ZodString, string, string>;
+        headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<[z.ZodString, z.ZodUnion<[z.ZodRecord<z.ZodString, z.ZodAny>, z.ZodEffects<z.ZodString, string, string>]>]>>>;
+        body: z.ZodOptional<z.ZodUnion<[z.ZodRecord<z.ZodString, z.ZodAny>, z.ZodEffects<z.ZodString, string, string>]>>;
+    } & {
+        config: z.ZodDefault<z.ZodObject<{
+            max_iterations: z.ZodDefault<z.ZodNumber>;
+        }, "strip", z.ZodTypeAny, {
+            max_iterations: number;
+        }, {
+            max_iterations?: number | undefined;
+        }>>;
+    }, "strip", z.ZodTypeAny, {
+        url: string;
+        method: "GET" | "POST" | "PUT" | "DELETE" | "PATCH" | "HEAD" | "OPTIONS";
+        config: {
+            max_iterations: number;
+        };
+        headers?: Record<string, string | Record<string, any>> | undefined;
+        body?: string | Record<string, any> | undefined;
+    }, {
+        url: string;
+        method: "GET" | "POST" | "PUT" | "DELETE" | "PATCH" | "HEAD" | "OPTIONS";
+        headers?: Record<string, string | Record<string, any>> | undefined;
+        body?: string | Record<string, any> | undefined;
+        config?: {
+            max_iterations?: number | undefined;
+        } | undefined;
+    }>;
+    dependencies: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodString, "many">>>;
+    tools: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodString, "many">>>;
+}, "strip", z.ZodTypeAny, {
+    type: "agent";
+    id: string;
+    http: {
+        url: string;
+        method: "GET" | "POST" | "PUT" | "DELETE" | "PATCH" | "HEAD" | "OPTIONS";
+        config: {
+            max_iterations: number;
+        };
+        headers?: Record<string, string | Record<string, any>> | undefined;
+        body?: string | Record<string, any> | undefined;
+    };
+    dependencies: string[];
+    tools: string[];
+    iterationContext?: {
+        originalNodeId: string;
+        iteratorNodeId: string;
+        index: number;
+    } | undefined;
+    activityConfig?: {
+        retryPolicy?: {
+            backoffCoefficient?: number | undefined;
+            initialInterval?: string | undefined;
+            maximumAttempts?: number | undefined;
+            maximumInterval?: string | undefined;
+        } | undefined;
+        startToCloseTimeout?: string | undefined;
+        scheduleToCloseTimeout?: string | undefined;
+    } | undefined;
+}, {
+    type: "agent";
+    id: string;
+    http: {
+        url: string;
+        method: "GET" | "POST" | "PUT" | "DELETE" | "PATCH" | "HEAD" | "OPTIONS";
+        headers?: Record<string, string | Record<string, any>> | undefined;
+        body?: string | Record<string, any> | undefined;
+        config?: {
+            max_iterations?: number | undefined;
+        } | undefined;
+    };
+    iterationContext?: {
+        originalNodeId: string;
+        iteratorNodeId: string;
+        index: number;
+    } | undefined;
+    activityConfig?: {
+        retryPolicy?: {
+            backoffCoefficient?: number | undefined;
+            initialInterval?: string | undefined;
+            maximumAttempts?: number | undefined;
+            maximumInterval?: string | undefined;
+        } | undefined;
+        startToCloseTimeout?: string | undefined;
+        scheduleToCloseTimeout?: string | undefined;
+    } | undefined;
+    dependencies?: string[] | undefined;
+    tools?: string[] | undefined;
+}>;
+export type AgentNode = z.infer<typeof AgentNodeSchema>;
+//# sourceMappingURL=agents.d.ts.map

package/dist/types/nodes/agents.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agents.d.ts","sourceRoot":"","sources":["../../../src/types/nodes/agents.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA4C1B,CAAC;AACH,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC"}

package/dist/types/nodes/agents.js

@@ -0,0 +1,48 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AgentNodeSchema = void 0;
+const zod_1 = require("zod");
+const http_1 = require("../config/http");
+const base_node_schema_1 = require("./common/base-node-schema");
+// Agent Node Schema
+exports.AgentNodeSchema = base_node_schema_1.BaseNodeSchema.extend({
+    type: zod_1.z.literal("agent").openapi({
+        description: "Specifies the node type as \`agent\`. Other available types include \`http\`, \`error_boundary\`, \`source_iterator\`, and \`destination\`.",
+        example: "agent",
+    }),
+    http: http_1.HTTPConfigSchema.extend({
+        config: zod_1.z
+            .object({
+            max_iterations: zod_1.z.number().default(5).openapi({
+                description: "Maximum number of iterations that the agent can run. An agent runs until it returns a completion schema response. You will be responsible for ensure the agent returns a `complete` response before this limit. You will receive an iteration",
+                example: 5,
+                default: 5,
+            }),
+        })
+            .default({
+            max_iterations: 5,
+        }),
+    }),
+    dependencies: zod_1.z
+        .array(zod_1.z.string())
+        .optional()
+        .default([])
+        .openapi({
+        description: "The dependencies of the agent. The dependencies must be the ids of the nodes that the agent depends on.",
+        example: ["node1", "node2"],
+    }),
+    tools: zod_1.z
+        .array(zod_1.z.string())
+        .optional()
+        .default([])
+        .openapi({
+        description: "The tools available to the agent. The tool names must be unique within the workflow and have no dashes or spaces. The tool needs to be defined in the global tools section.",
+        example: ["tool1", "tool2"],
+    }),
+}).openapi({
+    ref: "AgentNode",
+    title: "AgentNode",
+    description: "A node that can make use of HTTP Tools and Graph Tools. They are the only node type that can dynamically make use of other nodes,",
+    "x-tags": ["Nodes"],
+});
+//# sourceMappingURL=agents.js.map

package/dist/types/nodes/agents.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agents.js","sourceRoot":"","sources":["../../../src/types/nodes/agents.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AACxB,yCAAkD;AAClD,gEAA2D;AAE3D,oBAAoB;AACP,QAAA,eAAe,GAAG,iCAAc,CAAC,MAAM,CAAC;IACnD,IAAI,EAAE,OAAC,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC;QAC/B,WAAW,EACT,6IAA6I;QAC/I,OAAO,EAAE,OAAO;KACjB,CAAC;IACF,IAAI,EAAE,uBAAgB,CAAC,MAAM,CAAC;QAC5B,MAAM,EAAE,OAAC;aACN,MAAM,CAAC;YACN,cAAc,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;gBAC5C,WAAW,EACT,+OAA+O;gBACjP,OAAO,EAAE,CAAC;gBACV,OAAO,EAAE,CAAC;aACX,CAAC;SACH,CAAC;aACD,OAAO,CAAC;YACP,cAAc,EAAE,CAAC;SAClB,CAAC;KACL,CAAC;IACF,YAAY,EAAE,OAAC;SACZ,KAAK,CAAC,OAAC,CAAC,MAAM,EAAE,CAAC;SACjB,QAAQ,EAAE;SACV,OAAO,CAAC,EAAE,CAAC;SACX,OAAO,CAAC;QACP,WAAW,EACT,yGAAyG;QAC3G,OAAO,EAAE,CAAC,OAAO,EAAE,OAAO,CAAC;KAC5B,CAAC;IACJ,KAAK,EAAE,OAAC;SACL,KAAK,CAAC,OAAC,CAAC,MAAM,EAAE,CAAC;SACjB,QAAQ,EAAE;SACV,OAAO,CAAC,EAAE,CAAC;SACX,OAAO,CAAC;QACP,WAAW,EACT,6KAA6K;QAC/K,OAAO,EAAE,CAAC,OAAO,EAAE,OAAO,CAAC;KAC5B,CAAC;CACL,CAAC,CAAC,OAAO,CAAC;IACT,GAAG,EAAE,WAAW;IAChB,KAAK,EAAE,WAAW;IAClB,WAAW,EACT,mIAAmI;IACrI,QAAQ,EAAE,CAAC,OAAO,CAAC;CACpB,CAAC,CAAC"}