@darkhorseprojects/circuitry 0.3.10 → 0.4.1

package/examples/agent.circuitry.yaml

@@ -0,0 +1,24 @@
+circuitry: "0.4"
+title: Agent with prompt input
+inputs:
+  user_turn:
+    type: text
+    required: true
+entry: assistant
+resources:
+  user_turn:
+    type: input
+    from: user_turn
+  guide:
+    type: text
+    value: Be direct, accurate, and natural.
+  assistant:
+    type: agent
+    inputs: [guide, user_turn]
+    tools: [read, write, bash, run_graph]
+    instructions: Use the guide and answer the user.
+    expect:
+      response: str
+outputs:
+  response:
+    from: assistant.response

package/examples/imports.circuitry.yaml

@@ -0,0 +1,13 @@
+circuitry: "0.4"
+title: Imports and entries
+imports:
+  - path: ./agent.circuitry.yaml
+    resources: "*"
+    prefix: imported_
+entry: imported_assistant
+entries:
+  default: imported_assistant
+resources:
+  local_note:
+    type: text
+    value: Local resource.

package/examples/minimal.circuitry.yaml

@@ -0,0 +1,20 @@
+circuitry: "0.4"
+title: Minimal
+inputs:
+  user_turn:
+    type: text
+    required: true
+entry: assistant
+resources:
+  user_turn:
+    type: input
+    from: user_turn
+  assistant:
+    type: agent
+    inputs: [user_turn]
+    instructions: Answer the user.
+    expect:
+      response: str
+outputs:
+  response:
+    from: assistant.response

package/examples/run-resource.circuitry.yaml

@@ -0,0 +1,24 @@
+circuitry: "0.4"
+title: Run resource
+inputs:
+  user_turn:
+    type: text
+    required: true
+entry: assistant
+resources:
+  user_turn:
+    type: input
+    from: user_turn
+  recovered_context:
+    type: run
+    graph: ./context-recovery.circuitry.yaml
+    entry: recovery
+    inputs:
+      user_turn: user_turn
+  assistant:
+    type: agent
+    inputs: [user_turn, recovered_context]
+    instructions: Answer with recovered context when useful.
+outputs:
+  response:
+    from: assistant

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@darkhorseprojects/circuitry",
-  "version": "0.3.10",
+  "version": "0.4.1",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -9,9 +9,9 @@
       "types": "./dist/index.d.ts",
       "import": "./dist/index.js"
     },
-    "./node": {
-      "types": "./dist/node.d.ts",
-      "import": "./dist/node.js"
+    "./resolve": {
+      "types": "./dist/resolve.d.ts",
+      "import": "./dist/resolve.js"
     }
   },
   "bin": {
@@ -20,6 +20,9 @@
   "license": "MPL-2.0",
   "files": [
     "dist",
+    "SPEC.md",
+    "schema.json",
+    "examples",
     "LICENSE"
   ],
   "scripts": {
@@ -33,8 +36,10 @@
     "type": "git",
     "url": "git+https://github.com/darkhorseprojects/circuitry.git"
   },
-  "dependencies": {
-    "@earendil-works/pi-coding-agent": "latest",
+  "dependencies": {},
+  "devDependencies": {
+    "@types/node": "^20.11.0",
+    "typescript": "^5.3.3",
     "yaml": "^2.8.4",
     "zod": "^3.25.76"
   }

package/schema.json

@@ -0,0 +1,65 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://darkhorseprojects.github.io/circuitry/schema/0.4/schema.json",
+  "title": "Circuitry 0.4",
+  "type": "object",
+  "required": ["circuitry", "resources"],
+  "properties": {
+    "circuitry": { "const": "0.4" },
+    "title": { "type": "string" },
+    "description": { "type": "string" },
+    "imports": { "type": "array" },
+    "inputs": { "type": "object" },
+    "entry": { "type": "string" },
+    "entries": { "type": "object", "additionalProperties": { "type": "string" } },
+    "resources": {
+      "type": "object",
+      "additionalProperties": { "$ref": "#/$defs/resource" }
+    },
+    "outputs": {
+      "type": "object",
+      "additionalProperties": { "$ref": "#/$defs/output" }
+    }
+  },
+  "additionalProperties": true,
+  "$defs": {
+    "resource": {
+      "type": "object",
+      "required": ["type"],
+      "properties": {
+        "type": { "type": "string" },
+        "label": { "type": "string" },
+        "description": { "type": "string" },
+        "inputs": {
+          "oneOf": [
+            { "type": "array", "items": { "type": "string" } },
+            { "type": "object", "additionalProperties": { "type": "string" } }
+          ]
+        },
+        "from": { "type": "string" },
+        "value": true,
+        "path": { "type": "string" },
+        "uri": { "type": "string" },
+        "mime": { "type": "string" },
+        "identity": { "type": "string" },
+        "instructions": { "type": "string" },
+        "tools": { "type": "array", "items": { "type": "string" } },
+        "graph": { "type": "string" },
+        "entry": { "type": "string" },
+        "expect": true
+      },
+      "additionalProperties": true
+    },
+    "output": {
+      "type": "object",
+      "required": ["from"],
+      "properties": {
+        "from": { "type": "string" },
+        "type": { "type": "string" },
+        "mime": { "type": "string" },
+        "schema": true
+      },
+      "additionalProperties": true
+    }
+  }
+}

package/dist/bundle.d.ts

@@ -1,32 +0,0 @@
-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+yaml";
-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 stringifyBundle: (bundle: CircuitryBundle) => string;
-export declare const parseBundleText: (text: string) => CircuitryBundle;
-export declare const importBundleElements: (bundle: CircuitryBundle, opts?: {
-    offsetX?: number;
-    offsetY?: number;
-}) => SceneElement[];
-export {};

package/dist/host.d.ts

@@ -1,41 +0,0 @@
-import type { CircuitryGraph, CircuitryRuntimeInputs, 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;
-        inputs?: CircuitryRuntimeInputs;
-        standard?: CircuitryValidationStandard;
-        hostModel?: string;
-    }): Promise<{
-        completedAt: string;
-        runItems: SimulationRunItem[];
-    }>;
-}

package/dist/node.d.ts

@@ -1,58 +0,0 @@
-import type { CircuitryHost } from "./host";
-import type { CircuitryGraph, CircuitryRuntimeInputs, CircuitryValidationStandard } from "./graph";
-import type { NodeExecutionRequest, NodeExecutionResult, SimulationRunItem } from "./simulation";
-export declare const runNodeWithPiSDK: ({ model, prompt, images, tools, }: NodeExecutionRequest) => Promise<NodeExecutionResult>;
-export type CircuitryResourceOrigins = Record<string, string>;
-export type LoadedCircuitryGraph = {
-    filename: string;
-    text: string;
-    graph: CircuitryGraph;
-    origins: CircuitryResourceOrigins;
-};
-export declare const loadCircuitryGraphFile: (filename?: string, standard?: CircuitryValidationStandard, stack?: string[]) => Promise<LoadedCircuitryGraph>;
-export declare class NodeCircuitryHost implements CircuitryHost {
-    private resolveGraphFile;
-    private runFileFor;
-    private exists;
-    private parseIssue;
-    private parseSourceGraph;
-    private parseAndResolveGraph;
-    private readGraphFile;
-    readGraph(input?: {
-        filename?: string;
-    }): Promise<{
-        filename: string;
-        graph: CircuitryGraph;
-        text: string;
-        lastRun: unknown;
-    }>;
-    validateGraph(input: {
-        text?: string;
-        filename?: string;
-        graph?: CircuitryGraph;
-        standard?: CircuitryValidationStandard;
-    }): Promise<import("./graph").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;
-        inputs?: CircuitryRuntimeInputs;
-        standard?: CircuitryValidationStandard;
-        hostModel?: string;
-    }): Promise<{
-        completedAt: string;
-        runItems: SimulationRunItem[];
-    }>;
-}