@mplp/sdk-ts 1.0.1 → 1.0.3

package/src/builders/plan-builder.ts

@@ -1,56 +0,0 @@
-/**
- * MPLP Protocol v1.0.0 — Frozen Specification
- * Freeze Date: 2025-12-03
- * Status: FROZEN (no breaking changes permitted)
- * Governance: MPLP Protocol Governance Committee (MPGC)
- *
- * © 2025 邦士（北京）网络科技有限公司. All rights reserved.
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * http://www.apache.org/licenses/LICENSE-2.0
- */
-
-import { Plan, Context, validatePlan } from "@mplp/core";
-import { v4 as uuidv4 } from "uuid";
-
-export interface CreatePlanOptions {
-    title: string;
-    objective: string;
-    steps: Array<{
-        description: string;
-        toolName?: string;
-        parameters?: Record<string, any>;
-    }>;
-}
-
-export function createPlan(context: Context, options: CreatePlanOptions): Plan {
-    const plan: Plan = {
-        meta: {
-            protocol_version: "1.0.0",
-            schema_version: "1.0.0",
-            created_at: new Date().toISOString()
-        },
-        plan_id: uuidv4(),
-        context_id: context.context_id,
-        title: options.title,
-        objective: options.objective,
-        status: "draft",
-        steps: options.steps.map(step => ({
-            step_id: uuidv4(),
-            description: step.description,
-            status: "pending",
-            // Optional fields if supported by schema, but keeping it minimal for now
-            // toolName and parameters might need to go into specific step structure if schema supports it
-            // checking schema... PlanStepCore has step_id, description, status.
-            // If we want tool info, it might be in description or we need to check if schema allows extra props or specific step types.
-            // For now, let's stick to core fields.
-        }))
-    };
-
-    const validation = validatePlan(plan);
-    if (!validation.ok) {
-        throw new Error(`Invalid Plan generated: ${JSON.stringify(validation.errors)}`);
-    }
-
-    return plan;
-}

package/src/builders/trace-builder.ts

@@ -1,55 +0,0 @@
-/**
- * MPLP Protocol v1.0.0 — Frozen Specification
- * Freeze Date: 2025-12-03
- * Status: FROZEN (no breaking changes permitted)
- * Governance: MPLP Protocol Governance Committee (MPGC)
- *
- * © 2025 邦士（北京）网络科技有限公司. All rights reserved.
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * http://www.apache.org/licenses/LICENSE-2.0
- */
-
-import { Trace, Context, Plan, validateTrace } from "@mplp/core";
-import { v4 as uuidv4 } from "uuid";
-
-export interface AppendTraceOptions {
-    status: "completed" | "failed" | "running";
-    spans?: Array<{
-        name: string;
-        status: "completed" | "failed";
-    }>;
-}
-
-export function appendTrace(context: Context, plan: Plan, options: AppendTraceOptions): Trace {
-    const traceId = uuidv4();
-    const rootSpanId = uuidv4();
-
-    const trace: Trace = {
-        meta: {
-            protocol_version: "1.0.0",
-            schema_version: "1.0.0",
-            created_at: new Date().toISOString()
-        },
-        trace_id: traceId,
-        context_id: context.context_id,
-        plan_id: plan.plan_id,
-        status: options.status,
-        root_span: {
-            trace_id: traceId,
-            span_id: rootSpanId,
-            context_id: context.context_id
-        }
-    };
-
-    // Note: The current Trace schema is quite minimal. 
-    // If we want to add child spans, we would need a more complex builder that constructs the tree.
-    // For this basic builder, we just create the root trace object.
-
-    const validation = validateTrace(trace);
-    if (!validation.ok) {
-        throw new Error(`Invalid Trace generated: ${JSON.stringify(validation.errors)}`);
-    }
-
-    return trace;
-}

package/src/client/runtime-client.ts

@@ -1,103 +0,0 @@
-/**
- * MPLP Protocol v1.0.0 — Frozen Specification
- * Freeze Date: 2025-12-03
- * Status: FROZEN (no breaking changes permitted)
- * Governance: MPLP Protocol Governance Committee (MPGC)
- *
- * © 2025 邦士（北京）网络科技有限公司. All rights reserved.
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * http://www.apache.org/licenses/LICENSE-2.0
- */
-
-import {
-    RuntimeContext,
-    runSingleAgentFlow,
-    RuntimeResult,
-    InMemoryAEL,
-    InMemoryVSL,
-    RuntimeModuleRegistry,
-    ValueStateLayer,
-    ActionExecutionLayer
-} from "@mplp/runtime-minimal";
-import { SingleAgentFlowContract } from "@mplp/coordination";
-import { createContext, CreateContextOptions } from "../builders/context-builder";
-import { createPlan, CreatePlanOptions } from "../builders/plan-builder";
-import { createConfirm, CreateConfirmOptions } from "../builders/confirm-builder";
-import { appendTrace, AppendTraceOptions } from "../builders/trace-builder";
-import { v4 as uuidv4 } from "uuid";
-
-export interface MplpRuntimeClientOptions {
-    modules?: RuntimeModuleRegistry;
-    vsl?: ValueStateLayer;
-    ael?: ActionExecutionLayer;
-}
-
-export interface RunSingleAgentFlowInput {
-    contextOptions: CreateContextOptions;
-    planOptions: CreatePlanOptions;
-    confirmOptions: CreateConfirmOptions;
-    traceOptions: AppendTraceOptions;
-}
-
-export class MplpRuntimeClient {
-    private modules: RuntimeModuleRegistry;
-    private vsl: ValueStateLayer;
-    private ael: ActionExecutionLayer;
-
-    constructor(options: MplpRuntimeClientOptions = {}) {
-        this.modules = options.modules || {};
-        this.vsl = options.vsl || new InMemoryVSL();
-        this.ael = options.ael || new InMemoryAEL();
-    }
-
-    async runSingleAgentFlow(input: RunSingleAgentFlowInput): Promise<RuntimeResult> {
-        const runId = uuidv4();
-
-        // Default handlers that use the builders and provided options
-        const defaultModules: RuntimeModuleRegistry = {
-            context: async () => {
-                const context = createContext(input.contextOptions);
-                return { output: { context }, events: [] };
-            },
-            plan: async ({ ctx }) => {
-                if (!ctx.context) throw new Error("Context missing in coordination state");
-                const plan = createPlan(ctx.context, input.planOptions);
-                return { output: { plan }, events: [] };
-            },
-            confirm: async ({ ctx }) => {
-                if (!ctx.plan) throw new Error("Plan missing in coordination state");
-                const confirm = createConfirm(ctx.plan, input.confirmOptions);
-                return { output: { confirm }, events: [] };
-            },
-            trace: async ({ ctx }) => {
-                if (!ctx.context || !ctx.plan) throw new Error("Context or Plan missing in coordination state");
-                const trace = appendTrace(ctx.context, ctx.plan, input.traceOptions);
-                return { output: { trace }, events: [] };
-            }
-        };
-
-        // Merge modules: User provided modules override defaults
-        // This allows partial overriding (e.g. use default context/plan, but custom confirm)
-        const modules: RuntimeModuleRegistry = {
-            ...defaultModules,
-            ...this.modules
-        };
-
-        const runtimeContext: RuntimeContext = {
-            ids: { runId },
-            coordination: {
-                ids: { runId },
-                metadata: {}
-            },
-            events: []
-        };
-
-        return await runSingleAgentFlow({
-            flow: SingleAgentFlowContract,
-            runtimeContext,
-            modules,
-            vsl: this.vsl
-        });
-    }
-}

package/src/index.ts

@@ -1,18 +0,0 @@
-/**
- * MPLP Protocol v1.0.0 — Frozen Specification
- * Freeze Date: 2025-12-03
- * Status: FROZEN (no breaking changes permitted)
- * Governance: MPLP Protocol Governance Committee (MPGC)
- *
- * © 2025 邦士（北京）网络科技有限公司. All rights reserved.
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * http://www.apache.org/licenses/LICENSE-2.0
- */
-
-export * from "@mplp/core";
-export * from "./builders/context-builder";
-export * from "./builders/plan-builder";
-export * from "./builders/confirm-builder";
-export * from "./builders/trace-builder";
-export * from "./client/runtime-client";

package/tests/builders.test.ts

@@ -1,80 +0,0 @@
-/**
- * MPLP Protocol v1.0.0 — Frozen Specification
- * Freeze Date: 2025-12-03
- * Status: FROZEN (no breaking changes permitted)
- * Governance: MPLP Protocol Governance Committee (MPGC)
- *
- * © 2025 邦士（北京）网络科技有限公司. All rights reserved.
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * http://www.apache.org/licenses/LICENSE-2.0
- */
-
-import { describe, it, expect } from 'vitest';
-import { createContext } from '../src/builders/context-builder';
-import { createPlan } from '../src/builders/plan-builder';
-import { createConfirm } from '../src/builders/confirm-builder';
-import { appendTrace } from '../src/builders/trace-builder';
-
-describe('SDK Builders', () => {
-    it('should build a valid Context', () => {
-        const context = createContext({
-            title: 'Test Context',
-            root: { domain: 'test', environment: 'dev' }
-        });
-        expect(context.context_id).toBeDefined();
-        expect(context.title).toBe('Test Context');
-        expect(context.status).toBe('active');
-    });
-
-    it('should build a valid Plan', () => {
-        const context = createContext({
-            title: 'Test Context',
-            root: { domain: 'test', environment: 'dev' }
-        });
-        const plan = createPlan(context, {
-            title: 'Test Plan',
-            objective: 'Test Objective',
-            steps: [{ description: 'Step 1' }]
-        });
-        expect(plan.plan_id).toBeDefined();
-        expect(plan.context_id).toBe(context.context_id);
-        expect(plan.steps).toHaveLength(1);
-    });
-
-    it('should build a valid Confirm', () => {
-        const context = createContext({
-            title: 'Test Context',
-            root: { domain: 'test', environment: 'dev' }
-        });
-        const plan = createPlan(context, {
-            title: 'Test Plan',
-            objective: 'Test Objective',
-            steps: [{ description: 'Step 1' }]
-        });
-        const confirm = createConfirm(plan, {
-            status: 'approved'
-        });
-        expect(confirm.confirm_id).toBeDefined();
-        expect(confirm.target_id).toBe(plan.plan_id);
-        expect(confirm.status).toBe('approved');
-    });
-
-    it('should build a valid Trace', () => {
-        const context = createContext({
-            title: 'Test Context',
-            root: { domain: 'test', environment: 'dev' }
-        });
-        const plan = createPlan(context, {
-            title: 'Test Plan',
-            objective: 'Test Objective',
-            steps: [{ description: 'Step 1' }]
-        });
-        const trace = appendTrace(context, plan, {
-            status: 'completed'
-        });
-        expect(trace.trace_id).toBeDefined();
-        expect(trace.context_id).toBe(context.context_id);
-        expect(trace.status).toBe('completed');
-    });
-});

package/tests/client-single-agent.test.ts

@@ -1,48 +0,0 @@
-/**
- * MPLP Protocol v1.0.0 — Frozen Specification
- * Freeze Date: 2025-12-03
- * Status: FROZEN (no breaking changes permitted)
- * Governance: MPLP Protocol Governance Committee (MPGC)
- *
- * © 2025 邦士（北京）网络科技有限公司. All rights reserved.
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * http://www.apache.org/licenses/LICENSE-2.0
- */
-
-import { describe, it, expect } from 'vitest';
-import { MplpRuntimeClient } from '../src/client/runtime-client';
-import { SingleAgentFlowOutput } from '@mplp/coordination';
-
-describe('MplpRuntimeClient', () => {
-    it('should run a single agent flow with default builders', async () => {
-        const client = new MplpRuntimeClient();
-
-        const result = await client.runSingleAgentFlow({
-            contextOptions: {
-                title: 'Integration Test',
-                root: { domain: 'test', environment: 'ci' }
-            },
-            planOptions: {
-                title: 'Test Plan',
-                objective: 'Verify Client',
-                steps: [{ description: 'Do something' }]
-            },
-            confirmOptions: {
-                status: 'approved'
-            },
-            traceOptions: {
-                status: 'completed'
-            }
-        });
-
-        expect(result.success).toBe(true);
-        if (result.success) {
-            const output = result.output as SingleAgentFlowOutput;
-            expect(output.context.title).toBe('Integration Test');
-            expect(output.plan.title).toBe('Test Plan');
-            expect(output.confirm.status).toBe('approved');
-            expect(output.trace.status).toBe('completed');
-        }
-    });
-});

package/tsconfig.json

@@ -1,23 +0,0 @@
-{
-  "$comment": "MPLP Protocol v1.0.0 — Frozen Specification\nFreeze Date: 2025-12-03\nStatus: FROZEN (no breaking changes permitted)\nGovernance: MPLP Protocol Governance Committee (MPGC)\nCopyright: © 2025 邦士（北京）网络科技有限公司\nLicense: Apache-2.0\nAny normative change requires a new protocol version.",
-  "compilerOptions": {
-    "target": "ES2020",
-    "module": "commonjs",
-    "lib": [
-      "ES2020"
-    ],
-    "strict": true,
-    "esModuleInterop": true,
-    "skipLibCheck": true,
-    "forceConsistentCasingInFileNames": true,
-    "resolveJsonModule": true,
-    "declaration": true,
-    "moduleResolution": "node",
-    "downlevelIteration": true,
-    "outDir": "dist",
-    "rootDir": "src"
-  },
-  "include": [
-    "src"
-  ]
-}