@darkhorseprojects/circuitry 0.3.9 → 0.4.0

package/dist/graph.d.ts

@@ -1,187 +1,90 @@
-export declare const CIRCUITRY_SPEC_VERSION: "0.3.2";
+export declare const CIRCUITRY_SPEC_VERSION: "0.4";
 export type CircuitrySpecVersion = typeof CIRCUITRY_SPEC_VERSION;
-export type CircuitryNodeKind = "agent" | "input" | "tool" | "output" | string;
-export type CircuitryEdgeKind = "dependency" | "context" | "message" | "control" | string;
-export type CircuitryInputKind = "text" | "file" | "url" | "image" | "uri" | "canvas" | "mcp" | string;
-export type CircuitryAgent = {
-    uses?: string;
-    model?: string;
-    tools?: string[];
-    identity?: string;
-    personality?: string;
-    instructions?: string;
-    context?: string;
-};
-export type CircuitryInput = {
-    id: string;
-    type: CircuitryInputKind;
+export type CircuitrySchema = "str" | "int" | "float" | "bool" | "list" | "dict" | Record<string, unknown>;
+export type CircuitryInputKind = "text" | "file" | "url" | "image" | "uri" | "data" | string;
+export type CircuitryInputSpec = {
+    type?: CircuitryInputKind;
+    required?: boolean;
+    default?: unknown;
     label?: string;
-    value?: string;
-    uri?: string;
+    description?: string;
+    mime?: string;
     mimeType?: string;
-    data?: Record<string, unknown>;
 };
-export type CircuitryNode = {
-    id: string;
-    kind: CircuitryNodeKind;
-    label: string;
-    agent?: CircuitryAgent;
-    input?: Omit<CircuitryInput, "id">;
-    skills?: string[];
-    expect?: CircuitryExpectSchema;
-    data?: Record<string, unknown>;
-    view?: {
-        adapter?: "excalidraw" | string;
-        x?: number;
-        y?: number;
-        width?: number;
-        height?: number;
-        color?: string;
-    };
+export type CircuitryGraphArg = CircuitryInputSpec;
+export type CircuitryRuntimeInputs = Record<string, unknown>;
+export type CircuitryImport = {
+    path: string;
+    resources?: "*" | string[] | Record<string, string>;
+    prefix?: string;
 };
-export type CircuitryEdge = {
-    id?: string;
-    from: string;
-    to: string;
-    kind?: CircuitryEdgeKind;
+export type CircuitryResource = {
+    type: string;
     label?: string;
+    description?: string;
+    inputs?: string[] | Record<string, string>;
+    from?: string;
+    value?: unknown;
+    path?: string;
+    uri?: string;
+    mime?: string;
+    mimeType?: string;
     data?: Record<string, unknown>;
-};
-export type CircuitryExpectFieldType = "str" | "int" | "float" | "bool" | "list" | "dict" | (string & {});
-export type CircuitryExpectField = {
-    type: CircuitryExpectFieldType;
-    contains?: string;
-    items?: CircuitryExpectSchema | CircuitryExpectFieldType;
-    optional?: boolean;
-};
-export interface CircuitryExpectSchema {
-    [key: string]: CircuitryExpectField | CircuitryExpectFieldType | CircuitryExpectSchema;
-}
-export type CircuitryResourceText = {
-    type: "text";
-    value: string;
-    label?: string;
-};
-export type CircuitryResourceAgent = {
-    type: "agent";
     identity?: string;
-    label?: string;
     model?: string;
-    inputs?: string[];
-    tools?: string[];
-    skills?: string[];
-    expect?: CircuitryExpectSchema;
     instructions?: string;
     personality?: string;
     context?: string;
+    tools?: string[];
+    skills?: string[];
+    graph?: string;
+    entry?: string;
+    expect?: CircuitrySchema;
+    [key: `x-${string}`]: unknown;
 };
-export type CircuitryResourceTool = {
-    type: "tool";
-    label?: string;
-    inputs?: string[];
-    instructions?: string;
-};
-export type CircuitryResourceData = {
-    type: CircuitryInputKind;
-    value?: string;
-    uri?: string;
-    path?: string;
-    mimeType?: string;
-    label?: string;
-    data?: Record<string, unknown>;
-};
-export type CircuitryResourceEntry = CircuitryResourceText | CircuitryResourceAgent | CircuitryResourceTool | CircuitryResourceData;
-export type CircuitrySandboxProvider = "local" | "docker" | "e2b" | "daytona" | "cloudflare" | "modal" | "openai" | (string & {});
-export type CircuitrySandboxClient = {
-    provider: CircuitrySandboxProvider;
-    image?: string;
-    cwd?: string;
-    command?: string[];
-    env?: Record<string, string>;
-    secrets?: Record<string, string>;
-    timeoutMs?: number;
-    resources?: {
-        cpu?: number;
-        memoryMb?: number;
-        diskMb?: number;
-        gpu?: boolean | string;
-    };
-    providerOptions?: Record<string, unknown>;
-};
-export type CircuitryRuntimeProvider = "pi" | "claude-code" | "codex" | "opencode" | (string & {});
-export type CircuitryRuntimeClient = {
-    type?: "sdk" | "cli" | "mcp" | "http" | (string & {});
-    command?: string;
-    args?: string[];
-    cwd?: string;
-    env?: Record<string, string>;
-    config?: string;
-    agent?: string;
-    providerOptions?: Record<string, unknown>;
-};
-export type CircuitryRuntime = {
-    provider?: CircuitryRuntimeProvider;
-    model?: string;
-    client?: CircuitryRuntimeClient;
-    sandbox?: CircuitrySandboxClient;
-    permissions?: Record<string, unknown>;
-};
-export type CircuitryBuiltInValidationRule = "no-self-loops" | "no-unknown-edge-endpoints" | "require-executable-inputs" | "no-cycles";
-export type CircuitryValidationRuleEntry = CircuitryBuiltInValidationRule | {
-    rule: "require-executable-inputs";
-    executableKinds?: string[];
+export type CircuitryResourceEntry = CircuitryResource;
+export type CircuitryResourceText = CircuitryResource & {
+    type: "text";
 };
-export type CircuitryGraphValidation = {
-    rules?: CircuitryValidationRuleEntry[];
+export type CircuitryResourceAgent = CircuitryResource & {
+    type: "agent";
 };
-export type CircuitryGraphArg = {
-    type: CircuitryInputKind;
-    required?: boolean;
-    label?: string;
-    description?: string;
-    default?: unknown;
-    mimeType?: string;
+export type CircuitryResourceTool = CircuitryResource & {
+    type: "tool";
 };
-export type CircuitryRuntimeInputs = Record<string, unknown>;
-export type CircuitryImport = {
-    path: string;
-    resources: "*" | string[] | Record<string, string>;
-    prefix?: string;
+export type CircuitryResourceData = CircuitryResource;
+export type CircuitryOutput = {
+    from: string;
+    type?: string;
+    mime?: string;
+    schema?: CircuitrySchema;
 };
+export type CircuitryRuntime = Record<string, unknown>;
+export type CircuitryGraphValidation = Record<string, unknown>;
 export type CircuitryGraph = {
     circuitry: CircuitrySpecVersion | string;
     id?: string;
     title?: string;
     description?: string;
     imports?: CircuitryImport[];
-    args?: Record<string, CircuitryGraphArg>;
+    inputs?: Record<string, CircuitryInputSpec>;
+    args?: Record<string, CircuitryInputSpec>;
+    entry?: string;
+    entries?: Record<string, string>;
     resources?: Record<string, CircuitryResourceEntry>;
+    outputs?: Record<string, CircuitryOutput>;
     nodes?: CircuitryNode[];
     edges?: CircuitryEdge[];
-    agents?: never;
     runtime?: CircuitryRuntime;
     validation?: CircuitryGraphValidation;
     metadata?: Record<string, unknown>;
+    [key: `x-${string}`]: unknown;
 };
 export type LoadedCircuitryBundle = {
     circuitryBundle: CircuitrySpecVersion;
     graph: CircuitryGraph;
     origins: Record<string, string>;
 };
-export type CircuitryAgentPreset = {
-    name: string;
-    description?: string;
-    model?: string;
-    personality?: string;
-    instructions: string;
-    metadata?: Record<string, unknown>;
-};
-export type CircuitryValidationStandard = {
-    version?: CircuitrySpecVersion | string;
-    requireSpecVersion?: boolean;
-    rules?: CircuitryValidationRuleEntry[];
-    executableKinds?: string[];
-};
 export type CircuitryValidationIssue = {
     code: string;
     message: string;
@@ -192,17 +95,113 @@ export type CircuitryValidationResult = {
     errors: CircuitryValidationIssue[];
     standard: Required<CircuitryValidationStandard>;
 };
-export declare const DEFAULT_CIRCUITRY_VALIDATION_RULES: CircuitryValidationRuleEntry[];
+export type CircuitryValidationStandard = {
+    version?: CircuitrySpecVersion | string;
+    requireSpecVersion?: boolean;
+};
 export declare const DEFAULT_CIRCUITRY_VALIDATION_STANDARD: {
-    readonly version: "0.3.2";
+    readonly version: "0.4";
     readonly requireSpecVersion: true;
-    readonly rules: CircuitryValidationRuleEntry[];
-    readonly executableKinds: ["agent", "tool", "output"];
 };
+export type CircuitryDependency = {
+    from: string;
+    to: string;
+    name?: string;
+};
+export type CircuitryInspection = {
+    version: string;
+    title?: string;
+    entry?: string;
+    entries: Record<string, string>;
+    inputs: string[];
+    resources: string[];
+    outputs: string[];
+    dependencies: CircuitryDependency[];
+};
+export declare const createCircuitryValidationStandard: (standard?: CircuitryValidationStandard) => Required<CircuitryValidationStandard>;
+export declare const getResourceInputs: (resource: CircuitryResourceEntry) => CircuitryDependency[];
+export declare const getCircuitryDependencies: (graph: CircuitryGraph) => CircuitryDependency[];
+export declare const getCircuitryDependents: (graph: CircuitryGraph, resourceId: string) => string[];
+export declare const getCircuitryRunSet: (graph: CircuitryGraph, entry?: string | undefined) => string[];
+export declare const toposortCircuitryResources: (graph: CircuitryGraph, entry?: string) => string[];
+export declare const resolveCircuitrySource: (graph: CircuitryGraph) => CircuitryGraph;
 export declare const applyCircuitryRuntimeInputs: (graph: CircuitryGraph, inputs?: CircuitryRuntimeInputs) => CircuitryGraph;
-export declare const createCircuitryValidationStandard: (standard?: CircuitryValidationStandard, graph?: CircuitryGraph) => Required<CircuitryValidationStandard>;
-export declare const normalizeCircuitryGraph: (graph: CircuitryGraph) => CircuitryGraph;
+export declare const validateCircuitrySource: (graph: unknown, standard?: CircuitryValidationStandard) => CircuitryValidationResult;
 export declare const validateCircuitryGraphWithStandard: (graph: unknown, standard?: CircuitryValidationStandard) => CircuitryValidationResult;
 export declare const validateCircuitryExecutionGraphWithStandard: (graph: unknown, standard?: CircuitryValidationStandard) => CircuitryValidationResult;
 export declare const validateCircuitryGraph: (graph: unknown, standard?: CircuitryValidationStandard) => string[];
-export declare const isUriInput: (input: CircuitryInput | Omit<CircuitryInput, "id">) => boolean;
+export declare const inspectCircuitrySource: (graph: CircuitryGraph) => CircuitryInspection;
+export declare const parseCircuitrySource: (value: unknown) => CircuitryGraph;
+export declare const isUriInput: (input: {
+    type?: string;
+    uri?: string;
+    path?: string;
+}) => boolean;
+export type CircuitryNodeKind = "agent" | "input" | "tool" | "output" | string;
+export type CircuitryEdgeKind = "dependency" | "context" | "message" | "control" | string;
+export type CircuitryExpectFieldType = "str" | "int" | "float" | "bool" | "list" | "dict" | (string & {});
+export type CircuitryExpectField = {
+    type: CircuitryExpectFieldType;
+    contains?: string;
+    items?: CircuitrySchema | CircuitryExpectFieldType;
+    optional?: boolean;
+};
+export interface CircuitryExpectSchema {
+    [key: string]: CircuitryExpectField | CircuitryExpectFieldType | CircuitryExpectSchema;
+}
+export type CircuitryAgent = {
+    uses?: string;
+    model?: string;
+    tools?: string[];
+    identity?: string;
+    personality?: string;
+    instructions?: string;
+    context?: string;
+};
+export type CircuitryInput = {
+    id: string;
+    type: CircuitryInputKind;
+    label?: string;
+    value?: string;
+    uri?: string;
+    mimeType?: string;
+    data?: Record<string, unknown>;
+};
+export type CircuitryNode = {
+    id: string;
+    kind: CircuitryNodeKind;
+    label: string;
+    agent?: CircuitryAgent;
+    input?: Omit<CircuitryInput, "id">;
+    skills?: string[];
+    expect?: CircuitryExpectSchema;
+    data?: Record<string, unknown>;
+    view?: Record<string, unknown>;
+};
+export type CircuitryEdge = {
+    id?: string;
+    from: string;
+    to: string;
+    kind?: CircuitryEdgeKind;
+    label?: string;
+    data?: Record<string, unknown>;
+};
+export type CircuitrySandboxProvider = string;
+export type CircuitryRuntimeProvider = string;
+export type CircuitryBuiltInValidationRule = string;
+export type CircuitryValidationRuleEntry = string | {
+    rule: string;
+    executableKinds?: string[];
+};
+export type CircuitryAgentPreset = {
+    name: string;
+    description?: string;
+    model?: string;
+    personality?: string;
+    instructions: string;
+    metadata?: Record<string, unknown>;
+};
+export declare const normalizeCircuitryGraph: (graph: CircuitryGraph) => CircuitryGraph & {
+    nodes?: CircuitryNode[];
+    edges?: CircuitryEdge[];
+};