@aitos/core 1.0.0 → 1.0.1

package/dist/acs.d.ts

@@ -0,0 +1,108 @@
+/**
+ * AITOS Compact Syntax (ACS)
+ *
+ * ACS is a compact representation of Graph JSON, designed for:
+ * - AI generation (10-20x more compact than JSON)
+ * - Human readability (for auditing AI output)
+ * - Unambiguous compilation to/from Graph JSON
+ *
+ * Syntax:
+ *   graph <name> {
+ *     [mode: kernel|user]
+ *     [in: <type> | <name>: <type>, ...]
+ *     [out: <type>]
+ *
+ *     let <nodeId> = <atom>(<param>: <value>, ...)
+ *     if <refNodeId> {
+ *       <nodes...>
+ *     } [else {
+ *       <nodes...>
+ *     }]
+ *     loop [max: N] [cond: <storeKey>] {
+ *       <nodes...>
+ *     }
+ *     forEach <itemKey> in <arrayRef> [max: N] {
+ *       <nodes...>
+ *     }
+ *   }
+ */
+import { Graph } from './types';
+interface AcsNode {
+    type: 'let' | 'if' | 'loop' | 'forEach' | 'filter';
+    id?: string;
+    atom?: string;
+    params?: Record<string, any>;
+    ref?: string;
+    body?: AcsNode[];
+    elseBody?: AcsNode[];
+    maxIterations?: number;
+    condKey?: string;
+    itemKey?: string;
+    indexKey?: string;
+    arrayRef?: string;
+    maxItems?: number;
+    inlineCondAtom?: {
+        atom: string;
+        params: Record<string, any>;
+    };
+}
+interface AcsGraph {
+    name: string;
+    mode?: 'kernel' | 'user';
+    meta?: {
+        description?: string;
+        type?: string;
+        category?: string;
+        author?: string;
+    };
+    input?: Array<{
+        name: string;
+        type: string;
+    }>;
+    output?: string;
+    nodes: AcsNode[];
+}
+export declare class AcsParser {
+    private pos;
+    private src;
+    parse(text: string): AcsGraph;
+    private parseGraph;
+    private parseLet;
+    private parseIf;
+    private parseLoop;
+    private parseForEach;
+    private parseFilter;
+    private parseBody;
+    private parseParams;
+    private parseInputDecl;
+    private parseMetaDecl;
+    private readValue;
+    private readReference;
+    private readObject;
+    private readArray;
+    private skipWhitespaceAndComments;
+    private peek;
+    private expect;
+    private advance;
+    private readIdentifier;
+    private readNumber;
+    private readString;
+    private readUntil;
+}
+export declare class AcsCompiler {
+    compile(acsGraph: AcsGraph): Graph;
+    private compileNodes;
+    private compileSubGraph;
+}
+export declare class AcsDecompiler {
+    decompile(graph: Graph, name?: string): string;
+    private decompileNode;
+    private decompileSubGraph;
+    private formatParams;
+    private formatValue;
+    private extractArrayRef;
+    private extractCondRef;
+}
+export declare function compileAcs(text: string): Graph;
+export declare function decompileAcs(graph: Graph, name?: string): string;
+export {};