rax-flow-agents 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export * from "./schemas.js";
+export * from "./official-agents.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,sBAAsB,CAAC"}

package/dist/index.js

@@ -0,0 +1,3 @@
+export * from "./schemas.js";
+export * from "./official-agents.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,sBAAsB,CAAC"}

package/dist/official-agents.d.ts

@@ -0,0 +1,60 @@
+import { AgentDefinition, IModelProvider } from "@rax-flow/core";
+interface RuntimeOptions {
+    providers: Record<string, IModelProvider>;
+    defaultProvider?: string;
+    strongProvider?: string;
+    providerModels?: Record<string, string>;
+}
+export declare function buildOfficialAgents(): Record<string, AgentDefinition>;
+export declare function buildOfficialAgentsRuntime(options: RuntimeOptions): Record<string, AgentDefinition>;
+export declare function listOfficialAgents(): readonly [{
+    readonly name: "IntentClassifierAgent";
+    readonly role: "Classify user intent and pick workflow";
+    readonly activationWhen: "Always first";
+}, {
+    readonly name: "BrainstormAgent";
+    readonly role: "Generate diverse solution paths";
+    readonly activationWhen: "Idea exploration requested";
+}, {
+    readonly name: "SpecAgent";
+    readonly role: "Write actionable specification";
+    readonly activationWhen: "Requirements are vague";
+}, {
+    readonly name: "ArchitectureAgent";
+    readonly role: "Design scalable architecture";
+    readonly activationWhen: "System design requested";
+}, {
+    readonly name: "TaskPlannerAgent";
+    readonly role: "Break work into executable tasks";
+    readonly activationWhen: "Execution planning phase";
+}, {
+    readonly name: "CodeGeneratorAgent";
+    readonly role: "Generate implementation artifacts";
+    readonly activationWhen: "Code delivery required";
+}, {
+    readonly name: "TestAgent";
+    readonly role: "Generate and run test strategy";
+    readonly activationWhen: "Validation phase";
+}, {
+    readonly name: "ValidatorAgent";
+    readonly role: "Validate output schemas and constraints";
+    readonly activationWhen: "After each major step";
+}, {
+    readonly name: "FixAgent";
+    readonly role: "Patch detected defects";
+    readonly activationWhen: "Verify fails";
+}, {
+    readonly name: "OptimizerAgent";
+    readonly role: "Reduce latency/cost and improve quality";
+    readonly activationWhen: "Performance optimization needed";
+}, {
+    readonly name: "DocumentationAgent";
+    readonly role: "Generate technical/user docs";
+    readonly activationWhen: "Delivery finalization";
+}, {
+    readonly name: "BenchmarkAgent";
+    readonly role: "Measure quality/cost/latency deltas";
+    readonly activationWhen: "Benchmark mode enabled";
+}];
+export {};
+//# sourceMappingURL=official-agents.d.ts.map

package/dist/official-agents.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"official-agents.d.ts","sourceRoot":"","sources":["../src/official-agents.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAA2B,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAgC1F,UAAU,cAAc;IACtB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IAC1C,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACzC;AA2DD,wBAAgB,mBAAmB,IAAI,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAcrE;AAED,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAcnG;AAED,wBAAgB,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAEjC"}

package/dist/official-agents.js

@@ -0,0 +1,113 @@
+import { agentInputSchema, agentOutputSchema } from "./schemas.js";
+const officialAgents = [
+    { name: "IntentClassifierAgent", role: "Classify user intent and pick workflow", activationWhen: "Always first" },
+    { name: "BrainstormAgent", role: "Generate diverse solution paths", activationWhen: "Idea exploration requested" },
+    { name: "SpecAgent", role: "Write actionable specification", activationWhen: "Requirements are vague" },
+    { name: "ArchitectureAgent", role: "Design scalable architecture", activationWhen: "System design requested" },
+    { name: "TaskPlannerAgent", role: "Break work into executable tasks", activationWhen: "Execution planning phase" },
+    { name: "CodeGeneratorAgent", role: "Generate implementation artifacts", activationWhen: "Code delivery required" },
+    { name: "TestAgent", role: "Generate and run test strategy", activationWhen: "Validation phase" },
+    { name: "ValidatorAgent", role: "Validate output schemas and constraints", activationWhen: "After each major step" },
+    { name: "FixAgent", role: "Patch detected defects", activationWhen: "Verify fails" },
+    { name: "OptimizerAgent", role: "Reduce latency/cost and improve quality", activationWhen: "Performance optimization needed" },
+    { name: "DocumentationAgent", role: "Generate technical/user docs", activationWhen: "Delivery finalization" },
+    { name: "BenchmarkAgent", role: "Measure quality/cost/latency deltas", activationWhen: "Benchmark mode enabled" }
+];
+function deterministicRun(name, role) {
+    return async (input) => ({
+        agent: name,
+        success: true,
+        confidence: 0.8,
+        risks: [],
+        logs: [`${name} executed`, `Role: ${role}`],
+        data: {
+            summary: `${name} processed task ${input.taskId}`,
+            nextAction: "continue"
+        }
+    });
+}
+function pickProvider(options, input) {
+    const tier = String(input.context?.modelTier ?? "default");
+    const preferred = tier === "strong" ? options.strongProvider : options.defaultProvider;
+    if (preferred && options.providers[preferred]) {
+        return { name: preferred, provider: options.providers[preferred] };
+    }
+    const firstEntry = Object.entries(options.providers)[0];
+    const first = firstEntry?.[1];
+    if (!first) {
+        throw new Error("no_provider_available");
+    }
+    return { name: firstEntry[0], provider: first };
+}
+function runtimeRun(name, role, options) {
+    return async (input) => {
+        const selected = pickProvider(options, input);
+        const model = options.providerModels?.[selected.name];
+        const prompt = [
+            `You are ${name}.`,
+            `Role: ${role}.`,
+            "Return STRICT JSON matching the required schema.",
+            `Task: ${input.userPrompt}`,
+            `TaskId: ${input.taskId}`,
+            `Context: ${JSON.stringify(input.context ?? {})}`,
+            `Artifacts: ${JSON.stringify(input.artifacts ?? {})}`,
+            "Keep output concise and actionable."
+        ].join("\n");
+        try {
+            const response = await selected.provider.callStructured(prompt, agentOutputSchema, {
+                temperature: 0,
+                maxTokens: 1400,
+                model
+            });
+            return {
+                ...response.output,
+                logs: [...(response.output.logs ?? []), `${name} provider=${response.provider} model=${response.model}`],
+                usage: response.usage,
+                costUsd: response.costUsd
+            };
+        }
+        catch (error) {
+            return {
+                agent: name,
+                success: false,
+                confidence: 0.35,
+                risks: ["latency"],
+                logs: [`provider_call_failed:${String(error)}`],
+                data: {
+                    summary: `${name} failed to produce structured output`,
+                    nextAction: "retry"
+                }
+            };
+        }
+    };
+}
+export function buildOfficialAgents() {
+    return Object.fromEntries(officialAgents.map((agent) => [
+        agent.name,
+        {
+            name: agent.name,
+            role: agent.role,
+            activationWhen: agent.activationWhen,
+            inputSchema: agentInputSchema,
+            outputSchema: agentOutputSchema,
+            run: deterministicRun(agent.name, agent.role)
+        }
+    ]));
+}
+export function buildOfficialAgentsRuntime(options) {
+    return Object.fromEntries(officialAgents.map((agent) => [
+        agent.name,
+        {
+            name: agent.name,
+            role: agent.role,
+            activationWhen: agent.activationWhen,
+            inputSchema: agentInputSchema,
+            outputSchema: agentOutputSchema,
+            run: runtimeRun(agent.name, agent.role, options)
+        }
+    ]));
+}
+export function listOfficialAgents() {
+    return officialAgents;
+}
+//# sourceMappingURL=official-agents.js.map

package/dist/official-agents.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"official-agents.js","sourceRoot":"","sources":["../src/official-agents.ts"],"names":[],"mappings":"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"}

package/dist/schemas.d.ts

@@ -0,0 +1,56 @@
+export declare const agentOutputSchema: {
+    readonly type: "object";
+    readonly required: readonly ["agent", "success", "confidence", "risks", "logs", "data"];
+    readonly additionalProperties: false;
+    readonly properties: {
+        readonly agent: {
+            readonly type: "string";
+        };
+        readonly success: {
+            readonly type: "boolean";
+        };
+        readonly confidence: {
+            readonly type: "number";
+            readonly minimum: 0;
+            readonly maximum: 1;
+        };
+        readonly risks: {
+            readonly type: "array";
+            readonly items: {
+                readonly type: "string";
+            };
+        };
+        readonly logs: {
+            readonly type: "array";
+            readonly items: {
+                readonly type: "string";
+            };
+        };
+        readonly data: {
+            readonly type: "object";
+            readonly additionalProperties: true;
+        };
+    };
+};
+export declare const agentInputSchema: {
+    readonly type: "object";
+    readonly required: readonly ["taskId", "userPrompt"];
+    readonly additionalProperties: false;
+    readonly properties: {
+        readonly taskId: {
+            readonly type: "string";
+        };
+        readonly userPrompt: {
+            readonly type: "string";
+        };
+        readonly context: {
+            readonly type: "object";
+            readonly additionalProperties: true;
+        };
+        readonly artifacts: {
+            readonly type: "object";
+            readonly additionalProperties: true;
+        };
+    };
+};
+//# sourceMappingURL=schemas.d.ts.map

package/dist/schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../src/schemas.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAqBpB,CAAC;AAEX,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;CAUnB,CAAC"}

package/dist/schemas.js

@@ -0,0 +1,34 @@
+export const agentOutputSchema = {
+    type: "object",
+    required: ["agent", "success", "confidence", "risks", "logs", "data"],
+    additionalProperties: false,
+    properties: {
+        agent: { type: "string" },
+        success: { type: "boolean" },
+        confidence: { type: "number", minimum: 0, maximum: 1 },
+        risks: {
+            type: "array",
+            items: { type: "string" }
+        },
+        logs: {
+            type: "array",
+            items: { type: "string" }
+        },
+        data: {
+            type: "object",
+            additionalProperties: true
+        }
+    }
+};
+export const agentInputSchema = {
+    type: "object",
+    required: ["taskId", "userPrompt"],
+    additionalProperties: false,
+    properties: {
+        taskId: { type: "string" },
+        userPrompt: { type: "string" },
+        context: { type: "object", additionalProperties: true },
+        artifacts: { type: "object", additionalProperties: true }
+    }
+};
+//# sourceMappingURL=schemas.js.map

package/dist/schemas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.js","sourceRoot":"","sources":["../src/schemas.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,IAAI,EAAE,QAAQ;IACd,QAAQ,EAAE,CAAC,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC;IACrE,oBAAoB,EAAE,KAAK;IAC3B,UAAU,EAAE;QACV,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;QACzB,OAAO,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE;QAC5B,UAAU,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE;QACtD,KAAK,EAAE;YACL,IAAI,EAAE,OAAO;YACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;SAC1B;QACD,IAAI,EAAE;YACJ,IAAI,EAAE,OAAO;YACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;SAC1B;QACD,IAAI,EAAE;YACJ,IAAI,EAAE,QAAQ;YACd,oBAAoB,EAAE,IAAI;SAC3B;KACF;CACO,CAAC;AAEX,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,IAAI,EAAE,QAAQ;IACd,QAAQ,EAAE,CAAC,QAAQ,EAAE,YAAY,CAAC;IAClC,oBAAoB,EAAE,KAAK;IAC3B,UAAU,EAAE;QACV,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;QAC1B,UAAU,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;QAC9B,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,oBAAoB,EAAE,IAAI,EAAE;QACvD,SAAS,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,oBAAoB,EAAE,IAAI,EAAE;KAC1D;CACO,CAAC"}

package/package.json

@@ -0,0 +1,18 @@
+{
+  "name": "rax-flow-agents",
+  "version": "0.1.0",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "test": "vitest run --passWithNoTests",
+    "typecheck": "tsc -p tsconfig.json --noEmit"
+  },
+  "dependencies": {
+    "rax-flow-core": "0.1.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/src/index.ts

@@ -0,0 +1,2 @@
+export * from "./schemas.js";
+export * from "./official-agents.js";

package/src/official-agents.ts

@@ -0,0 +1,131 @@
+import { AgentDefinition, AgentInput, AgentOutput, IModelProvider } from "@rax-flow/core";
+import { agentInputSchema, agentOutputSchema } from "./schemas.js";
+
+const officialAgents = [
+  { name: "IntentClassifierAgent", role: "Classify user intent and pick workflow", activationWhen: "Always first" },
+  { name: "BrainstormAgent", role: "Generate diverse solution paths", activationWhen: "Idea exploration requested" },
+  { name: "SpecAgent", role: "Write actionable specification", activationWhen: "Requirements are vague" },
+  { name: "ArchitectureAgent", role: "Design scalable architecture", activationWhen: "System design requested" },
+  { name: "TaskPlannerAgent", role: "Break work into executable tasks", activationWhen: "Execution planning phase" },
+  { name: "CodeGeneratorAgent", role: "Generate implementation artifacts", activationWhen: "Code delivery required" },
+  { name: "TestAgent", role: "Generate and run test strategy", activationWhen: "Validation phase" },
+  { name: "ValidatorAgent", role: "Validate output schemas and constraints", activationWhen: "After each major step" },
+  { name: "FixAgent", role: "Patch detected defects", activationWhen: "Verify fails" },
+  { name: "OptimizerAgent", role: "Reduce latency/cost and improve quality", activationWhen: "Performance optimization needed" },
+  { name: "DocumentationAgent", role: "Generate technical/user docs", activationWhen: "Delivery finalization" },
+  { name: "BenchmarkAgent", role: "Measure quality/cost/latency deltas", activationWhen: "Benchmark mode enabled" }
+] as const;
+
+function deterministicRun(name: string, role: string) {
+  return async (input: AgentInput): Promise<AgentOutput> => ({
+    agent: name,
+    success: true,
+    confidence: 0.8,
+    risks: [],
+    logs: [`${name} executed`, `Role: ${role}`],
+    data: {
+      summary: `${name} processed task ${input.taskId}`,
+      nextAction: "continue"
+    }
+  });
+}
+
+interface RuntimeOptions {
+  providers: Record<string, IModelProvider>;
+  defaultProvider?: string;
+  strongProvider?: string;
+  providerModels?: Record<string, string>;
+}
+
+function pickProvider(options: RuntimeOptions, input: AgentInput): { name: string; provider: IModelProvider } {
+  const tier = String(input.context?.modelTier ?? "default");
+  const preferred = tier === "strong" ? options.strongProvider : options.defaultProvider;
+  if (preferred && options.providers[preferred]) {
+    return { name: preferred, provider: options.providers[preferred] };
+  }
+  const firstEntry = Object.entries(options.providers)[0];
+  const first = firstEntry?.[1];
+  if (!first) {
+    throw new Error("no_provider_available");
+  }
+  return { name: firstEntry[0], provider: first };
+}
+
+function runtimeRun(name: string, role: string, options: RuntimeOptions) {
+  return async (input: AgentInput): Promise<AgentOutput> => {
+    const selected = pickProvider(options, input);
+    const model = options.providerModels?.[selected.name];
+    const prompt = [
+      `You are ${name}.`,
+      `Role: ${role}.`,
+      "Return STRICT JSON matching the required schema.",
+      `Task: ${input.userPrompt}`,
+      `TaskId: ${input.taskId}`,
+      `Context: ${JSON.stringify(input.context ?? {})}`,
+      `Artifacts: ${JSON.stringify(input.artifacts ?? {})}`,
+      "Keep output concise and actionable."
+    ].join("\n");
+
+    try {
+      const response = await selected.provider.callStructured<AgentOutput>(prompt, agentOutputSchema, {
+        temperature: 0,
+        maxTokens: 1400,
+        model
+      });
+      return {
+        ...response.output,
+        logs: [...(response.output.logs ?? []), `${name} provider=${response.provider} model=${response.model}`],
+        usage: response.usage,
+        costUsd: response.costUsd
+      };
+    } catch (error) {
+      return {
+        agent: name,
+        success: false,
+        confidence: 0.35,
+        risks: ["latency"],
+        logs: [`provider_call_failed:${String(error)}`],
+        data: {
+          summary: `${name} failed to produce structured output`,
+          nextAction: "retry"
+        }
+      };
+    }
+  };
+}
+
+export function buildOfficialAgents(): Record<string, AgentDefinition> {
+  return Object.fromEntries(
+    officialAgents.map((agent) => [
+      agent.name,
+      {
+        name: agent.name,
+        role: agent.role,
+        activationWhen: agent.activationWhen,
+        inputSchema: agentInputSchema,
+        outputSchema: agentOutputSchema,
+        run: deterministicRun(agent.name, agent.role)
+      } satisfies AgentDefinition
+    ])
+  );
+}
+
+export function buildOfficialAgentsRuntime(options: RuntimeOptions): Record<string, AgentDefinition> {
+  return Object.fromEntries(
+    officialAgents.map((agent) => [
+      agent.name,
+      {
+        name: agent.name,
+        role: agent.role,
+        activationWhen: agent.activationWhen,
+        inputSchema: agentInputSchema,
+        outputSchema: agentOutputSchema,
+        run: runtimeRun(agent.name, agent.role, options)
+      } satisfies AgentDefinition
+    ])
+  );
+}
+
+export function listOfficialAgents() {
+  return officialAgents;
+}

package/src/schemas.ts

@@ -0,0 +1,34 @@
+export const agentOutputSchema = {
+  type: "object",
+  required: ["agent", "success", "confidence", "risks", "logs", "data"],
+  additionalProperties: false,
+  properties: {
+    agent: { type: "string" },
+    success: { type: "boolean" },
+    confidence: { type: "number", minimum: 0, maximum: 1 },
+    risks: {
+      type: "array",
+      items: { type: "string" }
+    },
+    logs: {
+      type: "array",
+      items: { type: "string" }
+    },
+    data: {
+      type: "object",
+      additionalProperties: true
+    }
+  }
+} as const;
+
+export const agentInputSchema = {
+  type: "object",
+  required: ["taskId", "userPrompt"],
+  additionalProperties: false,
+  properties: {
+    taskId: { type: "string" },
+    userPrompt: { type: "string" },
+    context: { type: "object", additionalProperties: true },
+    artifacts: { type: "object", additionalProperties: true }
+  }
+} as const;

package/tsconfig.json

@@ -0,0 +1,18 @@
+{
+  "extends": "../../tsconfig.base.json",
+  "compilerOptions": {
+    "rootDir": "src",
+    "outDir": "dist",
+    "composite": true,
+    "declaration": true,
+    "declarationMap": true
+  },
+  "include": [
+    "src/**/*.ts"
+  ],
+  "references": [
+    {
+      "path": "../core"
+    }
+  ]
+}