agency-lang 0.0.1 → 0.0.2

package/dist/backends/baseGenerator.d.ts

@@ -0,0 +1,54 @@
+import { AgencyComment, AgencyNode, AgencyProgram, Assignment, Literal, PromptLiteral, TypeAlias, TypeHint, TypeHintMap, VariableType } from "../types.js";
+import { AccessExpression, DotFunctionCall, DotProperty, IndexAccess } from "../types/access.js";
+import { AgencyArray, AgencyObject } from "../types/dataStructures.js";
+import { FunctionCall, FunctionDefinition } from "../types/function.js";
+import { GraphNodeDefinition } from "../types/graphNode.js";
+import { ImportStatement } from "../types/importStatement.js";
+import { MatchBlock } from "../types/matchBlock.js";
+import { UsesTool } from "../types/tools.js";
+import { WhileLoop } from "../types/whileLoop.js";
+export declare class BaseGenerator {
+    protected typeHints: TypeHintMap;
+    protected graphNodes: string[];
+    protected generatedStatements: string[];
+    protected generatedTypeAliases: string[];
+    protected functionScopedVariables: string[];
+    protected toolsUsed: string[];
+    protected typeAliases: Record<string, VariableType>;
+    protected functionsUsed: Set<string>;
+    protected importStatements: string[];
+    protected functionSignatures: Record<string, string[]>;
+    constructor();
+    generate(program: AgencyProgram): {
+        output: string;
+    };
+    protected generateBuiltins(): string;
+    protected processTypeAlias(node: TypeAlias): string;
+    protected processTypeHint(node: TypeHint): string;
+    protected collectFunctionSignature(node: FunctionDefinition): void;
+    protected processGraphNodeName(node: GraphNodeDefinition): void;
+    protected processNode(node: AgencyNode): string;
+    protected processWhileLoop(node: WhileLoop): string;
+    protected processImportStatement(node: ImportStatement): string;
+    protected processTool(node: FunctionDefinition): string;
+    protected processUsesTool(node: UsesTool): string;
+    protected processGraphNode(node: GraphNodeDefinition): string;
+    protected processAgencyObject(node: AgencyObject): string;
+    protected processAgencyArray(node: AgencyArray): string;
+    protected processComment(node: AgencyComment): string;
+    protected processReturnStatement(node: AgencyNode): string;
+    protected processAccessExpression(node: AccessExpression): string;
+    protected processMatchBlock(node: MatchBlock): string;
+    protected processDotProperty(node: DotProperty): string;
+    protected processDotFunctionCall(node: DotFunctionCall): string;
+    protected processIndexAccess(node: IndexAccess): string;
+    protected processAssignment(node: Assignment): string;
+    protected processPromptLiteral(variableName: string, node: PromptLiteral): string;
+    protected processFunctionDefinition(node: FunctionDefinition): string;
+    protected processFunctionCall(node: FunctionCall): string;
+    protected generateFunctionCallExpression(node: FunctionCall): string;
+    protected generateLiteral(literal: Literal): string;
+    protected generateImports(): string;
+    protected preprocess(): string;
+    protected postprocess(): string;
+}

package/dist/backends/graphGenerator.d.ts

@@ -0,0 +1,23 @@
+import { AgencyProgram, FunctionCall, TypeHintMap, VariableType } from "../types.js";
+import { TypeScriptGenerator } from "./typescriptGenerator.js";
+import { GraphNodeDefinition } from "../types/graphNode.js";
+import { ReturnStatement } from "../types/returnStatement.js";
+export declare class GraphGenerator extends TypeScriptGenerator {
+    protected typeHints: TypeHintMap;
+    protected generatedStatements: string[];
+    protected generatedTypeAliases: string[];
+    protected typeAliases: Record<string, VariableType>;
+    protected functionsUsed: Set<string>;
+    protected adjacentNodes: Record<string, string[]>;
+    protected currentAdjacentNodes: string[];
+    protected isInsideGraphNode: boolean;
+    constructor();
+    protected processReturnStatement(node: ReturnStatement): string;
+    protected processGraphNodeName(node: GraphNodeDefinition): void;
+    protected processGraphNode(node: GraphNodeDefinition): string;
+    protected processFunctionCall(node: FunctionCall): string;
+    protected generateNodeCallExpression(node: FunctionCall): string;
+    protected generateImports(): string;
+    protected postprocess(): string;
+}
+export declare function generateGraph(program: AgencyProgram): string;

package/dist/backends/graphGenerator.integration.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/backends/index.d.ts

@@ -0,0 +1,3 @@
+export * from "./baseGenerator.js";
+export * from "./typescriptGenerator.js";
+export * from "./graphGenerator.js";

package/dist/backends/typescriptGenerator/builtins.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Maps Agency built-in function names to TypeScript equivalents
+ */
+export declare const BUILTIN_FUNCTIONS: Record<string, string>;
+/**
+ * Maps an Agency function name to its TypeScript equivalent
+ * Returns the original name if not a built-in
+ */
+export declare function mapFunctionName(functionName: string): string;
+/**
+ * Generates helper functions for built-in Agency functions
+ */
+export declare function generateBuiltinHelpers(functionsUsed: Set<string>): string;

package/dist/backends/typescriptGenerator/typeToString.d.ts

@@ -0,0 +1,5 @@
+import { VariableType } from "../../types.js";
+/**
+ * Converts a VariableType to a string representation for naming/logging
+ */
+export declare function variableTypeToString(variableType: VariableType, typeAliases: Record<string, VariableType>): string;

package/dist/backends/typescriptGenerator/typeToZodSchema.d.ts

@@ -0,0 +1,5 @@
+import { VariableType } from "../../types.js";
+/**
+ * Maps Agency types to Zod schema strings
+ */
+export declare function mapTypeToZodSchema(variableType: VariableType, typeAliases: Record<string, VariableType>): string;

package/dist/backends/typescriptGenerator.d.ts

@@ -0,0 +1,56 @@
+import { AgencyComment, AgencyProgram, Assignment, Literal, PromptLiteral, PromptSegment, TypeAlias, TypeHint, TypeHintMap } from "../types.js";
+import { AccessExpression, DotFunctionCall, DotProperty, IndexAccess } from "../types/access.js";
+import { AgencyArray, AgencyObject } from "../types/dataStructures.js";
+import { FunctionCall, FunctionDefinition } from "../types/function.js";
+import { MatchBlock } from "../types/matchBlock.js";
+import { BaseGenerator } from "./baseGenerator.js";
+import { ReturnStatement } from "../types/returnStatement.js";
+import { UsesTool } from "../types/tools.js";
+import { ImportStatement } from "../types/importStatement.js";
+import { WhileLoop } from "../types/whileLoop.js";
+export declare class TypeScriptGenerator extends BaseGenerator {
+    constructor();
+    protected generateBuiltins(): string;
+    protected processTypeAlias(node: TypeAlias): string;
+    protected typeAliasToString(node: TypeAlias): string;
+    protected processTypeHint(node: TypeHint): string;
+    protected processAgencyObject(node: AgencyObject): string;
+    protected processAgencyArray(node: AgencyArray): string;
+    protected processComment(node: AgencyComment): string;
+    protected processReturnStatement(node: ReturnStatement): string;
+    protected processAccessExpression(node: AccessExpression): string;
+    protected processMatchBlock(node: MatchBlock): string;
+    protected processDotProperty(node: DotProperty): string;
+    protected processDotFunctionCall(node: DotFunctionCall): string;
+    protected processIndexAccess(node: IndexAccess): string;
+    protected processAssignment(node: Assignment): string;
+    protected processPromptLiteral(variableName: string, node: PromptLiteral): string;
+    protected processTool(node: FunctionDefinition): string;
+    protected processUsesTool(node: UsesTool): string;
+    /**
+     * Process a function definition node
+     */
+    protected processFunctionDefinition(node: FunctionDefinition): string;
+    /**
+     * Process a function call node
+     */
+    protected processFunctionCall(node: FunctionCall): string;
+    /**
+     * Generates TypeScript expression for a function call (without semicolon)
+     */
+    protected generateFunctionCallExpression(node: FunctionCall): string;
+    protected generateLiteral(literal: Literal): string;
+    protected generateImports(): string;
+    buildPromptString(segments: PromptSegment[], typeHints: TypeHintMap): string;
+    /**
+     * Generates an async for prompt-based assignments
+     */
+    generatePromptFunction({ variableName, functionArgs, prompt, }: {
+        variableName: string;
+        functionArgs: string[];
+        prompt: PromptLiteral;
+    }): string;
+    protected processImportStatement(node: ImportStatement): string;
+    protected processWhileLoop(node: WhileLoop): string;
+}
+export declare function generateTypeScript(program: AgencyProgram): string;

package/dist/backends/typescriptGenerator.integration.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/backends/typescriptGenerator.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/backends/utils.d.ts

@@ -0,0 +1,4 @@
+import { AccessExpression, FunctionCall, Literal } from "../types.js";
+import { AgencyObject, AgencyArray } from "../types/dataStructures.js";
+import { ReturnStatement } from "../types/returnStatement.js";
+export declare const wrapInReturn: (node: AccessExpression | FunctionCall | Literal | AgencyObject | AgencyArray) => ReturnStatement;

package/dist/generate-graph-file.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/generate-ts-file.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export * from "./parser.js";
+export * from "./types.js";
+export * from "./backends/index.js";

package/dist/parser.d.ts

@@ -0,0 +1,7 @@
+import { AgencyNode, AgencyProgram } from "./types.js";
+import { Parser, ParserResult } from "tarsec";
+export declare const agencyNode: Parser<AgencyNode[]>;
+export declare const agencyParser: Parser<AgencyProgram>;
+export declare const _multilineCommentParser: Parser<string[]>;
+export declare const multilineCommentParser: Parser<string[][]>;
+export declare function parseAgency(input: string): ParserResult<AgencyProgram>;

package/dist/parser.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/parsers/access.d.ts

@@ -0,0 +1,6 @@
+import { AccessExpression, DotFunctionCall, DotProperty, IndexAccess } from "../types/access.js";
+import { Parser, ParserResult } from "tarsec";
+export declare const dotPropertyParser: (input: string) => ParserResult<DotProperty>;
+export declare const indexAccessParser: (input: string) => ParserResult<IndexAccess>;
+export declare const dotFunctionCallParser: (input: string) => ParserResult<DotFunctionCall>;
+export declare const accessExpressionParser: Parser<AccessExpression>;

package/dist/parsers/access.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/parsers/assignment.d.ts

@@ -0,0 +1,3 @@
+import { Assignment } from "../types.js";
+import { Parser } from "tarsec";
+export declare const assignmentParser: Parser<Assignment>;

package/dist/parsers/body.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/parsers/comment.d.ts

@@ -0,0 +1,3 @@
+import { AgencyComment } from "../types.js";
+import { Parser } from "tarsec";
+export declare const commentParser: Parser<AgencyComment>;

package/dist/parsers/comment.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/parsers/dataStructures.d.ts

@@ -0,0 +1,5 @@
+import { AgencyArray, AgencyObject, AgencyObjectKV } from "../types/dataStructures.js";
+import { Parser } from "tarsec";
+export declare const agencyArrayParser: Parser<AgencyArray>;
+export declare const agencyObjectKVParser: Parser<AgencyObjectKV>;
+export declare const agencyObjectParser: Parser<AgencyObject>;

package/dist/parsers/dataStructures.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/parsers/function.d.ts

@@ -0,0 +1,9 @@
+import { AgencyNode, DocString, FunctionDefinition } from "../types.js";
+import { Parser } from "tarsec";
+import { GraphNodeDefinition } from "../types/graphNode.js";
+import { WhileLoop } from "../types/whileLoop.js";
+export declare const docStringParser: Parser<DocString>;
+export declare const bodyParser: Parser<AgencyNode[]>;
+export declare const whileLoopParser: Parser<WhileLoop>;
+export declare const functionParser: Parser<FunctionDefinition>;
+export declare const graphNodeParser: Parser<GraphNodeDefinition>;

package/dist/parsers/function.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/parsers/functionCall.d.ts

@@ -0,0 +1,3 @@
+import { FunctionCall } from "../types.js";
+import { Parser } from "tarsec";
+export declare const functionCallParser: Parser<FunctionCall>;

package/dist/parsers/functionCall.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/parsers/importStatement.d.ts

@@ -0,0 +1,3 @@
+import { ImportStatement } from "../types/importStatement.js";
+import { Parser } from "tarsec";
+export declare const importStatmentParser: Parser<ImportStatement>;

package/dist/parsers/importStatement.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/parsers/literals.d.ts

@@ -0,0 +1,9 @@
+import { InterpolationSegment, Literal, NumberLiteral, PromptLiteral, StringLiteral, TextSegment, VariableNameLiteral } from "../types.js";
+import { Parser } from "tarsec";
+export declare const textSegmentParser: Parser<TextSegment>;
+export declare const interpolationSegmentParser: Parser<InterpolationSegment>;
+export declare const promptParser: Parser<PromptLiteral>;
+export declare const numberParser: Parser<NumberLiteral>;
+export declare const stringParser: Parser<StringLiteral>;
+export declare const variableNameParser: Parser<VariableNameLiteral>;
+export declare const literalParser: Parser<Literal>;

package/dist/parsers/literals.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/parsers/matchBlock.d.ts

@@ -0,0 +1,9 @@
+import { Parser } from "tarsec";
+import { DefaultCase, MatchBlockCase } from "../types/matchBlock.js";
+export declare const defaultCaseParser: Parser<DefaultCase>;
+export declare const matchBlockParserCase: Parser<MatchBlockCase>;
+export declare const matchBlockParser: Parser<{
+    type: "matchBlock";
+    expression: import("../types.js").Literal;
+    cases: (import("../types.js").AgencyComment | MatchBlockCase)[];
+}>;

package/dist/parsers/matchBlock.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/parsers/parserUtils.d.ts

@@ -0,0 +1 @@
+export declare const optionalSemicolon: import("tarsec").Parser<";" | null>;

package/dist/parsers/returnStatement.d.ts

@@ -0,0 +1,3 @@
+import { ReturnStatement } from "../types/returnStatement.js";
+import { Parser } from "tarsec";
+export declare const returnStatementParser: Parser<ReturnStatement>;

package/dist/parsers/tools.d.ts

@@ -0,0 +1,3 @@
+import { UsesTool } from "../types/tools.js";
+import { Parser } from "tarsec";
+export declare const usesToolParser: Parser<UsesTool>;

package/dist/parsers/tools.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/parsers/typeHints.d.ts

@@ -0,0 +1,22 @@
+import { ArrayType, BooleanLiteralType, NumberLiteralType, ObjectProperty, ObjectType, PrimitiveType, StringLiteralType, TypeAlias, TypeAliasVariable, TypeHint, UnionType, VariableType } from "../types.js";
+import { Parser } from "tarsec";
+export declare const primitiveTypeParser: Parser<PrimitiveType>;
+export declare const typeAliasVariableParser: Parser<TypeAliasVariable>;
+export declare const arrayTypeParser: Parser<ArrayType>;
+export declare const angleBracketsArrayTypeParser: Parser<ArrayType>;
+export declare const stringLiteralTypeParser: Parser<StringLiteralType>;
+export declare const numberLiteralTypeParser: Parser<NumberLiteralType>;
+export declare const booleanLiteralTypeParser: Parser<BooleanLiteralType>;
+export declare const objectPropertyDelimiter: Parser<(string[] | ";")[]>;
+export declare const objectPropertyParser: Parser<ObjectProperty>;
+export declare const objectPropertyDescriptionParser: Parser<{
+    description: string;
+}>;
+export declare const objectPropertyWithDescriptionParser: Parser<ObjectProperty>;
+export declare const objectTypeParser: Parser<ObjectType>;
+export declare const unionItemParser: Parser<VariableType>;
+export declare const _unionTypeParser: Parser<UnionType>;
+export declare const unionTypeParser: Parser<UnionType>;
+export declare const variableTypeParser: Parser<VariableType>;
+export declare const typeHintParser: Parser<TypeHint>;
+export declare const typeAliasParser: Parser<TypeAlias>;

package/dist/parsers/typeHints.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/parsers/utils.d.ts

@@ -0,0 +1,5 @@
+import { Parser } from "tarsec";
+export declare const optionalSpaces: Parser<string[]>;
+export declare const backtick: Parser<"`">;
+export declare const comma: Parser<(string[] | ",")[]>;
+export declare const varNameChar: Parser<string>;

package/dist/parsers/whileLoop.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/templates/backends/graphGenerator/builtinTools.d.ts

@@ -0,0 +1,4 @@
+export declare const template = "function add({a, b}: {a:number, b:number}):number {\n  return a + b;\n}\n\n// Define the function tool for OpenAI\nconst addTool = {\n    type: \"function\" as const,\n    function: {\n      name: \"add\",\n      description:\n        \"Adds two numbers together and returns the result.\",\n      parameters: {\n        type: \"object\",\n        properties: {\n          a: {\n            type: \"number\",\n            description: \"The first number to add\",\n          },\n          b: {\n            type: \"number\",\n            description: \"The second number to add\",\n          },\n        },\n        required: [\"a\", \"b\"],\n        additionalProperties: false,\n      },\n    },\n  };";
+export type TemplateType = {};
+declare const render: (args: TemplateType) => string;
+export default render;

package/dist/templates/backends/graphGenerator/conditionalEdge.d.ts

@@ -0,0 +1,7 @@
+export declare const template = "graph.conditionalEdge(\"{{{fromNode}}}\", {{{toNodes}}});\n";
+export type TemplateType = {
+    fromNode: string | boolean | number;
+    toNodes: string | boolean | number;
+};
+declare const render: (args: TemplateType) => string;
+export default render;

package/dist/templates/backends/graphGenerator/edge.d.ts

@@ -0,0 +1,7 @@
+export declare const template = "graph.edge(\"{{{fromNode}}}\", \"{{{toNode}}}\");\n";
+export type TemplateType = {
+    fromNode: string | boolean | number;
+    toNode: string | boolean | number;
+};
+declare const render: (args: TemplateType) => string;
+export default render;

package/dist/templates/backends/graphGenerator/goToNode.d.ts

@@ -0,0 +1,7 @@
+export declare const template = "goToNode(\"{{{nodeName:string}}}\", { messages: state.messages, data: {{{data:string}}} });";
+export type TemplateType = {
+    nodeName: string;
+    data: string;
+};
+declare const render: (args: TemplateType) => string;
+export default render;

package/dist/templates/backends/graphGenerator/graphNode.d.ts

@@ -0,0 +1,9 @@
+export declare const template = "graph.node(\"{{{name}}}\", async (state) => {\n    {{#hasParam}}\n    const {{{paramName}}} = state.data;\n    {{/hasParam}}\n    {{{body}}}\n});\n";
+export type TemplateType = {
+    name: string | boolean | number;
+    hasParam: boolean;
+    paramName: string | boolean | number;
+    body: string | boolean | number;
+};
+declare const render: (args: TemplateType) => string;
+export default render;

package/dist/templates/backends/graphGenerator/imports.d.ts

@@ -0,0 +1,6 @@
+export declare const template = "import OpenAI from \"openai\";\nimport { zodResponseFormat } from \"openai/helpers/zod\";\nimport { z } from \"zod\";\nimport * as readline from \"readline\";\nimport fs from \"fs\";\nimport { Graph, goToNode } from \"simplemachine\";\nimport { StatelogClient } from \"statelog-client\";\nimport { nanoid } from \"nanoid\";\n\nconst statelogHost = \"http://localhost:1065\";\nconst traceId = nanoid();\nconst statelogClient = new StatelogClient({host: statelogHost, tid: traceId});\nconst model = \"gpt-4.1-nano-2025-04-14\";\n\nconst openai = new OpenAI({\n  apiKey: process.env.OPENAI_API_KEY,\n});\n\ntype State = {\n  messages: string[];\n  data: any;\n}\n\n// enable debug logging\nconst graphConfig = {\n  debug: {\n    log: true,\n    logData: true,\n  },\n  statelogHost,\n  traceId\n};\n\n// Define the names of the nodes in the graph\n// Useful for type safety\nconst nodes = {{{nodes:string}}} as const;\ntype Node = (typeof nodes)[number];\n\nconst graph = new Graph<State, Node>(nodes, graphConfig);";
+export type TemplateType = {
+    nodes: string;
+};
+declare const render: (args: TemplateType) => string;
+export default render;

package/dist/templates/backends/graphGenerator/node.d.ts

@@ -0,0 +1,7 @@
+export declare const template = "let {{{name:string}}}:any;\n\ngraph.node(\"{{{name}}}\", async (state) => {\n  const innerFunc = async () => {\n    {{{body}}}\n  };\n  {{{name}}} = await innerFunc();\n  return {{{name}}};\n});\n";
+export type TemplateType = {
+    name: string;
+    body: string | boolean | number;
+};
+declare const render: (args: TemplateType) => string;
+export default render;

package/dist/templates/backends/graphGenerator/promptNode.d.ts

@@ -0,0 +1,8 @@
+export declare const template = "let {{{name:string}}}:any;\n\ngraph.node(\"{{{name}}}\", async (state) => {\n  const innerFunc = {{{promptFunction:string}}};\n  {{{name}}} = await innerFunc({{{argsStr:string}}});\n  return {{{name}}};\n});\n";
+export type TemplateType = {
+    name: string;
+    promptFunction: string;
+    argsStr: string;
+};
+declare const render: (args: TemplateType) => string;
+export default render;

package/dist/templates/backends/graphGenerator/startNode.d.ts

@@ -0,0 +1,6 @@
+export declare const template = "const initialState: State = {messages: [], data: {}};\nconst finalState = graph.run(\"{{{startNode}}}\", initialState);";
+export type TemplateType = {
+    startNode: string | boolean | number;
+};
+declare const render: (args: TemplateType) => string;
+export default render;

package/dist/templates/backends/typescriptGenerator/builtinFunctions/fetch.d.ts

@@ -0,0 +1,4 @@
+export declare const template = "async function _builtinFetch(url: string, args: any): any {\n  const result = await fetch(url, args);\n  try {\n    const text = await result.text();\n    return text;\n  } catch (e) {\n    throw new Error(`Failed to get text from ${url}: ${e}`);\n  }\n}";
+export type TemplateType = {};
+declare const render: (args: TemplateType) => string;
+export default render;

package/dist/templates/backends/typescriptGenerator/builtinFunctions/fetchJSON.d.ts

@@ -0,0 +1,4 @@
+export declare const template = "async function _builtinFetchJSON(url: string, args: any): any {\n  const result = await fetch(url, args);\n  try {\n    const json = await result.json();\n    return json;\n  } catch (e) {\n    throw new Error(`Failed to parse JSON from ${url}: ${e}`);\n  }\n}";
+export type TemplateType = {};
+declare const render: (args: TemplateType) => string;
+export default render;

package/dist/templates/backends/typescriptGenerator/builtinFunctions/input.d.ts

@@ -0,0 +1,4 @@
+export declare const template = "function _builtinInput(prompt: string): Promise<string> {\n  const rl = readline.createInterface({\n    input: process.stdin,\n    output: process.stdout\n  });\n\n  return new Promise((resolve) => {\n    rl.question(prompt, (answer: string) => {\n      rl.close();\n      resolve(answer);\n    });\n  });\n}";
+export type TemplateType = {};
+declare const render: (args: TemplateType) => string;
+export default render;

package/dist/templates/backends/typescriptGenerator/builtinFunctions/read.d.ts

@@ -0,0 +1,4 @@
+export declare const template = "function _builtinRead(filename: string): string {\n  const data = fs.readFileSync(filename);\n  const contents = data.toString('utf8');\n  return contents;\n}";
+export type TemplateType = {};
+declare const render: (args: TemplateType) => string;
+export default render;

package/dist/templates/backends/typescriptGenerator/builtinTools.d.ts

@@ -0,0 +1,4 @@
+export declare const template = "function add({a, b}: {a:number, b:number}):number {\n  return a + b;\n}\n\n// Define the function tool for OpenAI\nconst addTool = {\n    type: \"function\" as const,\n    function: {\n      name: \"add\",\n      description:\n        \"Adds two numbers together and returns the result.\",\n      parameters: {\n        type: \"object\",\n        properties: {\n          a: {\n            type: \"number\",\n            description: \"The first number to add\",\n          },\n          b: {\n            type: \"number\",\n            description: \"The second number to add\",\n          },\n        },\n        required: [\"a\", \"b\"],\n        additionalProperties: false,\n      },\n    },\n  };";
+export type TemplateType = {};
+declare const render: (args: TemplateType) => string;
+export default render;

package/dist/templates/backends/typescriptGenerator/functionDefinition.d.ts

@@ -0,0 +1,8 @@
+export declare const template = "async function {{{functionName:string}}}({{{args}}}) {\n    {{{functionBody}}}\n}";
+export type TemplateType = {
+    functionName: string;
+    args: string | boolean | number;
+    functionBody: string | boolean | number;
+};
+declare const render: (args: TemplateType) => string;
+export default render;

package/dist/templates/backends/typescriptGenerator/imports.d.ts

@@ -0,0 +1,4 @@
+export declare const template = "import OpenAI from \"openai\";\nimport { zodResponseFormat } from \"openai/helpers/zod\";\nimport { z } from \"zod\";\nimport * as readline from \"readline\";\nimport fs from \"fs\";\nimport { StatelogClient } from \"statelog-client\";\nimport { nanoid } from \"nanoid\";\n\nconst statelogHost = \"http://localhost:1065\";\nconst traceId = nanoid();\nconst statelogClient = new StatelogClient({host: statelogHost, tid: traceId});\n\nconst model = \"gpt-5-nano-2025-08-07\";\n\nconst openai = new OpenAI({\n  apiKey: process.env.OPENAI_API_KEY,\n});";
+export type TemplateType = {};
+declare const render: (args: TemplateType) => string;
+export default render;

package/dist/templates/backends/typescriptGenerator/promptFunction.d.ts

@@ -0,0 +1,12 @@
+export declare const template = "\nasync function _{{{variableName:string}}}({{{argsStr:string}}}): Promise<{{{typeString:string}}}> {\n  const prompt = {{{promptCode:string}}};\n  const startTime = performance.now();\n  const messages:any[] = [{ role: \"user\", content: prompt }];\n  const tools = {{{tools}}};\n\n  let completion = await openai.chat.completions.create({\n    model,\n    messages,\n    tools,\n    response_format: zodResponseFormat(z.object({\n      value: {{{zodSchema:string}}}\n    }), \"{{{variableName:string}}}_response\"),\n  });\n  const endTime = performance.now();\n  statelogClient.promptCompletion({\n    messages,\n    completion,\n    model,\n    timeTaken: endTime - startTime,\n  });\n\n  let responseMessage = completion.choices[0].message;\n  // Handle function calls\n  while (responseMessage.tool_calls && responseMessage.tool_calls.length > 0) {\n    // Add assistant's response with tool calls to message history\n    messages.push(responseMessage);\n    let toolCallStartTime, toolCallEndTime;\n\n    // Process each tool call\n    for (const toolCall of responseMessage.tool_calls) {\n      {{{functionCalls:string}}}\n    }\n\n    const nextStartTime = performance.now();\n    // Get the next response from the model\n    completion = await openai.chat.completions.create({\n      model,\n      messages: messages,\n      tools: tools,\n    });\n    const nextEndTime = performance.now();\n\n    statelogClient.promptCompletion({\n      messages,\n      completion,\n      model,\n      timeTaken: nextEndTime - nextStartTime,\n    });\n\n    responseMessage = completion.choices[0].message;\n  }\n\n  // Add final assistant response to history\n  messages.push(responseMessage);\n\n  try {\n  const result = JSON.parse(completion.choices[0].message.content || \"\");\n  return result.value;\n  } catch (e) {\n    return completion.choices[0].message.content;\n    // console.error(\"Error parsing response for variable '{{{variableName:string}}}':\", e);\n    // console.error(\"Full completion response:\", JSON.stringify(completion, null, 2));\n    // throw e;\n  }\n}\n";
+export type TemplateType = {
+    variableName: string;
+    argsStr: string;
+    typeString: string;
+    promptCode: string;
+    tools: string | boolean | number;
+    zodSchema: string;
+    functionCalls: string;
+};
+declare const render: (args: TemplateType) => string;
+export default render;

package/dist/templates/backends/typescriptGenerator/tool.d.ts

@@ -0,0 +1,9 @@
+export declare const template = "const {{{name:string}}}Tool: OpenAI.Chat.Completions.ChatCompletionTool = {\n    type: \"function\",\n    function: {\n      name: \"{{{name:string}}}\",\n      description:\n        \"{{{description:string}}}\",\n      parameters: {\n        type: \"object\",\n        properties: {{{properties:string}}},\n        required: [{{{requiredParameters:string}}}],\n        additionalProperties: false,\n      },\n    },\n  };\n";
+export type TemplateType = {
+    name: string;
+    description: string;
+    properties: string;
+    requiredParameters: string;
+};
+declare const render: (args: TemplateType) => string;
+export default render;

package/dist/templates/backends/typescriptGenerator/toolCall.d.ts

@@ -0,0 +1,6 @@
+export declare const template = "if (toolCall.type === \"function\" &&\n  toolCall.function.name === \"{{{name:string}}}\"\n) {\n  const args = JSON.parse(toolCall.function.arguments);\n\n  toolCallStartTime = performance.now();\n  const result = await {{{name}}}(args);\n  toolCallEndTime = performance.now();\n\n  console.log(\"Tool '{{{name:string}}}' called with arguments:\", args);\n  console.log(\"Tool '{{{name:string}}}' returned result:\", result);\n\nstatelogClient.toolCall({\n    toolName: \"{{{name:string}}}\",\n    args,\n    output: result,\n    model,\n    timeTaken: toolCallEndTime - toolCallStartTime,\n  });\n\n  // Add function result to messages\n  messages.push({\n    role: \"tool\",\n    tool_call_id: toolCall.id,\n    content: JSON.stringify(result),\n  });\n}";
+export type TemplateType = {
+    name: string;
+};
+declare const render: (args: TemplateType) => string;
+export default render;

package/dist/types/access.d.ts

@@ -0,0 +1,22 @@
+import { FunctionCall } from "../types.js";
+import { Literal } from "./literals.js";
+import { AgencyArray } from "./dataStructures.js";
+export type DotProperty = {
+    type: "dotProperty";
+    object: Literal | FunctionCall | AccessExpression;
+    propertyName: string;
+};
+export type IndexAccess = {
+    type: "indexAccess";
+    array: Literal | FunctionCall | AccessExpression | AgencyArray;
+    index: Literal | FunctionCall | AccessExpression;
+};
+export type DotFunctionCall = {
+    type: "dotFunctionCall";
+    object: Literal | FunctionCall | AccessExpression;
+    functionCall: FunctionCall;
+};
+export type AccessExpression = {
+    type: "accessExpression";
+    expression: DotProperty | IndexAccess | DotFunctionCall;
+};

package/dist/types/dataStructures.d.ts

@@ -0,0 +1,14 @@
+import { AccessExpression, Literal } from "../types.js";
+import { FunctionCall } from "./function.js";
+export type AgencyArray = {
+    type: "agencyArray";
+    items: (AccessExpression | Literal | FunctionCall | AgencyObject | AgencyArray | AccessExpression)[];
+};
+export type AgencyObjectKV = {
+    key: string;
+    value: AccessExpression | Literal | FunctionCall | AgencyObject | AgencyArray | AccessExpression;
+};
+export type AgencyObject = {
+    type: "agencyObject";
+    entries: AgencyObjectKV[];
+};

package/dist/types/function.d.ts

@@ -0,0 +1,19 @@
+import { AgencyNode } from "../types.js";
+import { AccessExpression } from "./access.js";
+import { Literal } from "./literals.js";
+export type FunctionDefinition = {
+    type: "function";
+    functionName: string;
+    parameters: string[];
+    body: AgencyNode[];
+    docString?: DocString;
+};
+export type FunctionCall = {
+    type: "functionCall";
+    functionName: string;
+    arguments: (Literal | AccessExpression | FunctionCall)[];
+};
+export type DocString = {
+    type: "docString";
+    value: string;
+};

package/dist/types/graphNode.d.ts

@@ -0,0 +1,14 @@
+import { AgencyNode, FunctionCall } from "../types.js";
+import { AccessExpression } from "./access.js";
+import { Literal } from "./literals.js";
+export type GraphNodeDefinition = {
+    type: "graphNode";
+    nodeName: string;
+    parameters: string[];
+    body: AgencyNode[];
+};
+export type NodeCall = {
+    type: "nodeCall";
+    nodeName: string;
+    arguments: (Literal | AccessExpression | FunctionCall)[];
+};

package/dist/types/importStatement.d.ts

@@ -0,0 +1,5 @@
+export type ImportStatement = {
+    type: "importStatement";
+    importedNames: string;
+    modulePath: string;
+};

package/dist/types/literals.d.ts

@@ -0,0 +1,26 @@
+export type Literal = NumberLiteral | StringLiteral | VariableNameLiteral | PromptLiteral;
+export type NumberLiteral = {
+    type: "number";
+    value: string;
+};
+export type StringLiteral = {
+    type: "string";
+    value: string;
+};
+export type VariableNameLiteral = {
+    type: "variableName";
+    value: string;
+};
+export type PromptSegment = TextSegment | InterpolationSegment;
+export type TextSegment = {
+    type: "text";
+    value: string;
+};
+export type InterpolationSegment = {
+    type: "interpolation";
+    variableName: string;
+};
+export type PromptLiteral = {
+    type: "prompt";
+    segments: PromptSegment[];
+};

package/dist/types/matchBlock.d.ts

@@ -0,0 +1,17 @@
+import { Assignment, AgencyComment } from "../types.js";
+import { AccessExpression } from "./access.js";
+import { Literal } from "./literals.js";
+import { FunctionCall } from "./function.js";
+import { AgencyArray, AgencyObject } from "./dataStructures.js";
+import { ReturnStatement } from "./returnStatement.js";
+export type DefaultCase = "_";
+export type MatchBlockCase = {
+    type: "matchBlockCase";
+    caseValue: AccessExpression | Literal | DefaultCase;
+    body: Assignment | Literal | FunctionCall | AccessExpression | AgencyArray | AgencyObject | ReturnStatement;
+};
+export type MatchBlock = {
+    type: "matchBlock";
+    expression: Literal;
+    cases: (MatchBlockCase | AgencyComment)[];
+};

package/dist/types/returnStatement.d.ts

@@ -0,0 +1,6 @@
+import { AccessExpression, FunctionCall, Literal } from "../types.js";
+import { AgencyArray, AgencyObject } from "./dataStructures.js";
+export type ReturnStatement = {
+    type: "returnStatement";
+    value: AccessExpression | FunctionCall | Literal | AgencyObject | AgencyArray;
+};

package/dist/types/tools.d.ts

@@ -0,0 +1,4 @@
+export type UsesTool = {
+    type: "usesTool";
+    toolName: string;
+};

package/dist/types/typeHints.d.ts

@@ -0,0 +1,48 @@
+export type TypeHint = {
+    type: "typeHint";
+    variableName: string;
+    variableType: VariableType;
+};
+export type VariableType = PrimitiveType | ArrayType | StringLiteralType | NumberLiteralType | BooleanLiteralType | UnionType | ObjectType | TypeAliasVariable;
+export type PrimitiveType = {
+    type: "primitiveType";
+    value: string;
+};
+export type ArrayType = {
+    type: "arrayType";
+    elementType: VariableType;
+};
+export type StringLiteralType = {
+    type: "stringLiteralType";
+    value: string;
+};
+export type NumberLiteralType = {
+    type: "numberLiteralType";
+    value: string;
+};
+export type BooleanLiteralType = {
+    type: "booleanLiteralType";
+    value: "true" | "false";
+};
+export type UnionType = {
+    type: "unionType";
+    types: VariableType[];
+};
+export type ObjectProperty = {
+    key: string;
+    value: VariableType;
+    description?: string;
+};
+export type ObjectType = {
+    type: "objectType";
+    properties: ObjectProperty[];
+};
+export type TypeAlias = {
+    type: "typeAlias";
+    aliasName: string;
+    aliasedType: VariableType;
+};
+export type TypeAliasVariable = {
+    type: "typeAliasVariable";
+    aliasName: string;
+};

package/dist/types/whileLoop.d.ts

@@ -0,0 +1,6 @@
+import { AccessExpression, AgencyNode, FunctionCall, Literal } from "../types.js";
+export type WhileLoop = {
+    type: "whileLoop";
+    condition: FunctionCall | AccessExpression | Literal;
+    body: AgencyNode[];
+};

package/dist/types.d.ts

@@ -0,0 +1,37 @@
+import { Literal } from "./types/literals.js";
+import { TypeAlias, TypeHint, VariableType } from "./types/typeHints.js";
+import { MatchBlock } from "./types/matchBlock.js";
+import { AccessExpression } from "./types/access.js";
+import { FunctionCall, FunctionDefinition } from "./types/function.js";
+import { AgencyArray, AgencyObject } from "./types/dataStructures.js";
+import { GraphNodeDefinition } from "./types/graphNode.js";
+import { ReturnStatement } from "./types/returnStatement.js";
+import { UsesTool } from "./types/tools.js";
+import { ImportStatement } from "./types/importStatement.js";
+import { WhileLoop } from "./types/whileLoop.js";
+export * from "./types/access.js";
+export * from "./types/dataStructures.js";
+export * from "./types/function.js";
+export * from "./types/graphNode.js";
+export * from "./types/importStatement.js";
+export * from "./types/literals.js";
+export * from "./types/matchBlock.js";
+export * from "./types/returnStatement.js";
+export * from "./types/tools.js";
+export * from "./types/typeHints.js";
+export * from "./types/whileLoop.js";
+export type Assignment = {
+    type: "assignment";
+    variableName: string;
+    value: AccessExpression | Literal | FunctionCall | AgencyObject | AgencyArray;
+};
+export type AgencyComment = {
+    type: "comment";
+    content: string;
+};
+export type AgencyNode = TypeHint | TypeAlias | UsesTool | GraphNodeDefinition | FunctionDefinition | Assignment | Literal | FunctionCall | MatchBlock | ReturnStatement | AccessExpression | AgencyComment | AgencyObject | AgencyArray | ImportStatement | WhileLoop;
+export type AgencyProgram = {
+    type: "agencyProgram";
+    nodes: AgencyNode[];
+};
+export type TypeHintMap = Record<string, VariableType>;

package/dist/utils.d.ts

@@ -0,0 +1,3 @@
+export declare function escape(str: string): string;
+export declare function deepCopy<T>(obj: T): T;
+export declare function zip<T, U>(arr1: T[], arr2: U[]): Array<[T, U]>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agency-lang",
-  "version": "0.0.1",
+  "version": "0.0.2",
   "description": "The Agency language",
   "main": "index.js",
   "scripts": {