@darkhorseprojects/circuitry 0.2.12 → 0.2.14

package/dist/bundle.d.ts

@@ -0,0 +1,31 @@
+type SceneElement = {
+    id: string;
+    type: string;
+    x?: number;
+    y?: number;
+    frameId?: string | null;
+    containerId?: string | null;
+    boundElements?: readonly {
+        id: string;
+        type: string;
+    }[] | null;
+    startBinding?: {
+        elementId?: string;
+    } | null;
+    endBinding?: {
+        elementId?: string;
+    } | null;
+};
+export declare const BUNDLE_MIME = "application/vnd.circuitry.bundle+json";
+export type CircuitryBundle = {
+    version: 1;
+    createdAt: string;
+    elements: SceneElement[];
+};
+export declare const createBundleFromSelection: (elements: readonly SceneElement[], selectedIds: Readonly<Record<string, true>>) => CircuitryBundle | null;
+export declare const parseBundleText: (text: string) => CircuitryBundle;
+export declare const importBundleElements: (bundle: CircuitryBundle, opts?: {
+    offsetX?: number;
+    offsetY?: number;
+}) => SceneElement[];
+export {};

package/dist/graph.d.ts

@@ -0,0 +1,221 @@
+export declare const CIRCUITRY_SPEC_VERSION: "0.2";
+export declare const CIRCUITRY_SPEC_VERSION_LEGACY: "0.1";
+export type CircuitrySpecVersion = typeof CIRCUITRY_SPEC_VERSION | typeof CIRCUITRY_SPEC_VERSION_LEGACY;
+export type CircuitryNodeKind = "agent" | "input" | "tool" | "output" | string;
+export type CircuitryEdgeKind = "context" | "dependency" | "message" | "control" | string;
+export type CircuitryInputKind = "text" | "file" | "url" | "image" | "uri" | "canvas" | "mcp" | string;
+export type CircuitryAgent = {
+    uses?: string;
+    model?: string;
+    tools?: string[];
+    thinkingLevel?: "off" | "minimal" | "low" | "medium" | "high" | "xhigh";
+    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?: {
+        adapter?: "excalidraw" | string;
+        x?: number;
+        y?: number;
+        width?: number;
+        height?: number;
+        color?: string;
+    };
+};
+export type CircuitryEdge = {
+    id?: string;
+    from: string;
+    to: string;
+    kind?: CircuitryEdgeKind;
+    label?: string;
+    data?: Record<string, unknown>;
+};
+export type CircuitryExpectFieldType = "str" | "int" | "float" | "bool" | "list" | "dict" | (string & {});
+export type CircuitryExpectField = {
+    type: CircuitryExpectFieldType;
+    /** Optional substring that must appear in the string value. */
+    contains?: string;
+    /** For list fields: shape of each item. */
+    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;
+    thinkingLevel?: "off" | "minimal" | "low" | "medium" | "high" | "xhigh";
+    /** References to other resource ids that feed this agent. */
+    inputs?: string[];
+    /** Per-resource tool whitelist. */
+    tools?: string[];
+    /** Per-resource skill whitelist. */
+    skills?: string[];
+    /** Expected output schema — stored as metadata, used for optional validation. */
+    expect?: CircuitryExpectSchema;
+    instructions?: string;
+    personality?: string;
+    context?: string;
+};
+export type CircuitryResourceTool = {
+    type: "tool";
+    label?: string;
+    inputs?: string[];
+    instructions?: string;
+};
+export type CircuitryResourceEntry = CircuitryResourceText | CircuitryResourceAgent | CircuitryResourceTool;
+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 CircuitryStringValidationMatch = {
+    field: string;
+    value: string;
+    nodeKinds?: string[];
+    edgeKinds?: string[];
+};
+export type CircuitryAdditionalValidationRule = {
+    rule: "require-graph-field";
+    field: string;
+} | {
+    rule: "require-node-field";
+    field: string;
+    nodeKinds?: string[];
+} | {
+    rule: "require-edge-field";
+    field: string;
+    edgeKinds?: string[];
+} | {
+    rule: "require-string";
+    graph?: CircuitryStringValidationMatch[];
+    nodes?: CircuitryStringValidationMatch[];
+    edges?: CircuitryStringValidationMatch[];
+} | {
+    rule: "reject-string";
+    graph?: CircuitryStringValidationMatch[];
+    nodes?: CircuitryStringValidationMatch[];
+    edges?: CircuitryStringValidationMatch[];
+};
+export type CircuitryValidationRuleEntry = CircuitryBuiltInValidationRule | {
+    rule: CircuitryBuiltInValidationRule;
+    executableKinds?: string[];
+} | CircuitryAdditionalValidationRule;
+export type CircuitryGraphValidation = {
+    rules?: CircuitryValidationRuleEntry[];
+};
+export type CircuitryGraph = {
+    /** Spec version. Use "0.2" for new graphs. */
+    circuitry: CircuitrySpecVersion | string;
+    id?: string;
+    title?: string;
+    description?: string;
+    resources?: Record<string, CircuitryResourceEntry>;
+    agents?: Record<string, Omit<CircuitryNode, "id" | "kind"> & {
+        kind?: "agent";
+    }>;
+    inputs?: Record<string, Omit<CircuitryInput, "id">>;
+    nodes?: CircuitryNode[];
+    edges?: CircuitryEdge[];
+    runtime?: CircuitryRuntime;
+    validation?: CircuitryGraphValidation;
+    metadata?: Record<string, unknown>;
+};
+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;
+    path?: Array<string | number>;
+};
+export type CircuitryValidationResult = {
+    ok: boolean;
+    errors: CircuitryValidationIssue[];
+    standard: Required<CircuitryValidationStandard>;
+};
+export declare const DEFAULT_CIRCUITRY_VALIDATION_RULES: CircuitryValidationRuleEntry[];
+export declare const DEFAULT_CIRCUITRY_VALIDATION_STANDARD: {
+    readonly version: "0.2";
+    readonly requireSpecVersion: true;
+    readonly rules: CircuitryValidationRuleEntry[];
+    readonly executableKinds: ["agent", "tool", "output"];
+};
+export declare const createCircuitryValidationStandard: (standard?: CircuitryValidationStandard, graph?: CircuitryGraph) => Required<CircuitryValidationStandard>;
+export declare const normalizeCircuitryGraph: (graph: CircuitryGraph) => CircuitryGraph;
+export declare const validateCircuitryGraphWithStandard: (graph: unknown, standard?: CircuitryValidationStandard) => CircuitryValidationResult;
+export declare const validateCircuitryGraph: (graph: unknown, standard?: CircuitryValidationStandard) => string[];
+export declare const parseCircuitryJson: (text: string, standard?: CircuitryValidationStandard, options?: {
+    validate?: boolean;
+}) => CircuitryGraph;
+export declare const stringifyCircuitryJson: (graph: CircuitryGraph) => string;
+export declare const isUriInput: (input: CircuitryInput | Omit<CircuitryInput, "id">) => boolean;

package/dist/host.d.ts

@@ -0,0 +1,40 @@
+import type { CircuitryGraph, CircuitryValidationResult, CircuitryValidationStandard } from "./graph";
+import type { SimulationRunItem } from "./simulation";
+export interface CircuitryHost {
+    readGraph(input: {
+        filename?: string;
+    }): Promise<{
+        filename: string;
+        graph: CircuitryGraph;
+        text: string;
+        lastRun?: any;
+    }>;
+    validateGraph(input: {
+        text?: string;
+        filename?: string;
+        graph?: CircuitryGraph;
+        standard?: CircuitryValidationStandard;
+    }): Promise<CircuitryValidationResult>;
+    writeGraph(input: {
+        text?: string;
+        filename?: string;
+        graph?: CircuitryGraph;
+        mode?: "replace";
+        standard?: CircuitryValidationStandard;
+    }): Promise<{
+        filename: string;
+        graph: CircuitryGraph;
+        mode: "replace";
+    }>;
+    runGraph(input: {
+        source?: "current" | "text";
+        text?: string;
+        filename?: string;
+        selectedNodeId?: string;
+        standard?: CircuitryValidationStandard;
+        hostModel?: string;
+    }): Promise<{
+        completedAt: string;
+        runItems: SimulationRunItem[];
+    }>;
+}

package/dist/index.d.ts

@@ -0,0 +1,11 @@
+export * from "./types";
+export * from "./graph";
+export * from "./yaml";
+export * from "./presets";
+export * from "./scheduler";
+export * from "./simulation";
+export * from "./bundle";
+export * from "./runtime";
+export * from "./host";
+export * from "./tools";
+export * from "./node";