@gt-fe/eap-sdk 0.0.6

package/dist/service/http-server.js

@@ -0,0 +1,89 @@
+import { createServer } from 'node:http';
+export function createAgentHttpServer(service) {
+    return createServer(async (request, response) => {
+        try {
+            await handleRequest(service, request, response);
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            if (response.headersSent) {
+                response.write(`event: error\ndata: ${JSON.stringify({ error: message })}\n\n`);
+                response.end();
+            }
+            else {
+                writeJson(response, 500, { error: message });
+            }
+        }
+    });
+}
+async function handleRequest(service, request, response) {
+    const method = request.method ?? 'GET';
+    const pathname = new URL(request.url ?? '/', 'http://localhost').pathname;
+    if (method === 'GET' && pathname === '/health') {
+        writeJson(response, 200, {
+            status: 'ok',
+            agentCode: service.target.agentCode,
+            version: service.target.version,
+        });
+        return;
+    }
+    const route = /^\/api\/v1\/agents\/([^/]+)\/(invoke|stream)$/.exec(pathname);
+    if (!route || method !== 'POST') {
+        writeJson(response, 404, { error: 'Route not found' });
+        return;
+    }
+    const agentCode = decodeURIComponent(route[1]);
+    if (agentCode !== service.target.agentCode) {
+        writeJson(response, 404, { error: `Selected Agent is ${service.target.agentCode}` });
+        return;
+    }
+    const body = await readJsonBody(request);
+    if (typeof body.input !== 'string') {
+        writeJson(response, 400, { error: 'Request body requires string input' });
+        return;
+    }
+    const options = {
+        sessionId: stringValue(body.sessionId),
+        taskId: stringValue(body.taskId),
+        ...(isRecord(body.config) ? { config: body.config } : {}),
+        ...(isRecord(body.executionContext)
+            ? { executionContext: body.executionContext }
+            : {}),
+    };
+    if (route[2] === 'invoke') {
+        writeJson(response, 200, await service.invoke(body.input, options));
+        return;
+    }
+    response.writeHead(200, {
+        'Content-Type': 'text/event-stream; charset=utf-8',
+        'Cache-Control': 'no-cache, no-transform',
+        Connection: 'keep-alive',
+    });
+    for await (const event of service.stream(body.input, options)) {
+        response.write(`event: ${event.type}\ndata: ${JSON.stringify({ ...event.data, correlationId: event.correlationId, taskId: event.taskId, timestamp: event.timestamp })}\n\n`);
+    }
+    response.end();
+}
+async function readJsonBody(request) {
+    const chunks = [];
+    for await (const chunk of request)
+        chunks.push(Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk));
+    const raw = Buffer.concat(chunks).toString('utf8');
+    if (!raw)
+        return {};
+    const body = JSON.parse(raw);
+    if (!body || typeof body !== 'object' || Array.isArray(body))
+        throw new Error('Request body must be an object');
+    return body;
+}
+function stringValue(value) {
+    return typeof value === 'string' && value.length > 0 ? value : undefined;
+}
+function isRecord(value) {
+    return Boolean(value && typeof value === 'object' && !Array.isArray(value));
+}
+function writeJson(response, status, body) {
+    response.writeHead(status, { 'Content-Type': 'application/json; charset=utf-8' });
+    response.end(JSON.stringify(body));
+}
+//# sourceMappingURL=http-server.js.map

package/dist/service/http-server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-server.js","sourceRoot":"","sources":["../../src/service/http-server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAA0D,MAAM,WAAW,CAAC;AAGjG,MAAM,UAAU,qBAAqB,CAAC,OAAqB;IACzD,OAAO,YAAY,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,EAAE;QAC9C,IAAI,CAAC;YACH,MAAM,aAAa,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC;QAClD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACvE,IAAI,QAAQ,CAAC,WAAW,EAAE,CAAC;gBACzB,QAAQ,CAAC,KAAK,CAAC,uBAAuB,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,MAAM,CAAC,CAAC;gBAChF,QAAQ,CAAC,GAAG,EAAE,CAAC;YACjB,CAAC;iBAAM,CAAC;gBACN,SAAS,CAAC,QAAQ,EAAE,GAAG,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC;YAC/C,CAAC;QACH,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC;AAED,KAAK,UAAU,aAAa,CAAC,OAAqB,EAAE,OAAwB,EAAE,QAAwB;IACpG,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,KAAK,CAAC;IACvC,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,GAAG,IAAI,GAAG,EAAE,kBAAkB,CAAC,CAAC,QAAQ,CAAC;IAC1E,IAAI,MAAM,KAAK,KAAK,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;QAC/C,SAAS,CAAC,QAAQ,EAAE,GAAG,EAAE;YACvB,MAAM,EAAE,IAAI;YACZ,SAAS,EAAE,OAAO,CAAC,MAAM,CAAC,SAAS;YACnC,OAAO,EAAE,OAAO,CAAC,MAAM,CAAC,OAAO;SAChC,CAAC,CAAC;QACH,OAAO;IACT,CAAC;IAED,MAAM,KAAK,GAAG,+CAA+C,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC7E,IAAI,CAAC,KAAK,IAAI,MAAM,KAAK,MAAM,EAAE,CAAC;QAChC,SAAS,CAAC,QAAQ,EAAE,GAAG,EAAE,EAAE,KAAK,EAAE,iBAAiB,EAAE,CAAC,CAAC;QACvD,OAAO;IACT,CAAC;IACD,MAAM,SAAS,GAAG,kBAAkB,CAAC,KAAK,CAAC,CAAC,CAAE,CAAC,CAAC;IAChD,IAAI,SAAS,KAAK,OAAO,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC;QAC3C,SAAS,CAAC,QAAQ,EAAE,GAAG,EAAE,EAAE,KAAK,EAAE,qBAAqB,OAAO,CAAC,MAAM,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;QACrF,OAAO;IACT,CAAC;IACD,MAAM,IAAI,GAAG,MAAM,YAAY,CAAC,OAAO,CAAC,CAAC;IACzC,IAAI,OAAO,IAAI,CAAC,KAAK,KAAK,QAAQ,EAAE,CAAC;QACnC,SAAS,CAAC,QAAQ,EAAE,GAAG,EAAE,EAAE,KAAK,EAAE,oCAAoC,EAAE,CAAC,CAAC;QAC1E,OAAO;IACT,CAAC;IACD,MAAM,OAAO,GAAwB;QACnC,SAAS,EAAE,WAAW,CAAC,IAAI,CAAC,SAAS,CAAC;QACtC,MAAM,EAAE,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC;QAChC,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,MAAuC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC1F,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,gBAAgB,CAAC;YACjC,CAAC,CAAC,EAAE,gBAAgB,EAAE,IAAI,CAAC,gBAAsE,EAAE;YACnG,CAAC,CAAC,EAAE,CAAC;KACR,CAAC;IACF,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,QAAQ,EAAE,CAAC;QAC1B,SAAS,CAAC,QAAQ,EAAE,GAAG,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC;QACpE,OAAO;IACT,CAAC;IAED,QAAQ,CAAC,SAAS,CAAC,GAAG,EAAE;QACtB,cAAc,EAAE,kCAAkC;QAClD,eAAe,EAAE,wBAAwB;QACzC,UAAU,EAAE,YAAY;KACzB,CAAC,CAAC;IACH,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,OAAO,CAAC,EAAE,CAAC;QAC9D,QAAQ,CAAC,KAAK,CAAC,UAAU,KAAK,CAAC,IAAI,WAAW,IAAI,CAAC,SAAS,CAAC,EAAE,GAAG,KAAK,CAAC,IAAI,EAAE,aAAa,EAAE,KAAK,CAAC,aAAa,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,SAAS,EAAE,KAAK,CAAC,SAAS,EAAE,CAAC,MAAM,CAAC,CAAC;IAC/K,CAAC;IACD,QAAQ,CAAC,GAAG,EAAE,CAAC;AACjB,CAAC;AAED,KAAK,UAAU,YAAY,CAAC,OAAwB;IAClD,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,OAAO;QAAE,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;IACpG,MAAM,GAAG,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;IACnD,IAAI,CAAC,GAAG;QAAE,OAAO,EAAE,CAAC;IACpB,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC7B,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAC;IAChH,OAAO,IAA+B,CAAC;AACzC,CAAC;AAED,SAAS,WAAW,CAAC,KAAc;IACjC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;AAC3E,CAAC;AAED,SAAS,QAAQ,CAAC,KAAc;IAC9B,OAAO,OAAO,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC;AAC9E,CAAC;AAED,SAAS,SAAS,CAAC,QAAwB,EAAE,MAAc,EAAE,IAAa;IACxE,QAAQ,CAAC,SAAS,CAAC,MAAM,EAAE,EAAE,cAAc,EAAE,iCAAiC,EAAE,CAAC,CAAC;IAClF,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC;AACrC,CAAC"}

package/dist/service/index.d.ts

@@ -0,0 +1,5 @@
+export * from './types.js';
+export * from './events.js';
+export * from './create-agent-service.js';
+export type { GraphMessage, MessageService, MessageRecord, RuntimeEvent, SessionRecord, SessionService, } from '@gt-fe/eap-runtime';
+//# sourceMappingURL=index.d.ts.map

package/dist/service/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/service/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,2BAA2B,CAAC;AAC1C,YAAY,EACV,YAAY,EACZ,cAAc,EACd,aAAa,EACb,YAAY,EACZ,aAAa,EACb,cAAc,GACf,MAAM,oBAAoB,CAAC"}

package/dist/service/index.js

@@ -0,0 +1,4 @@
+export * from './types.js';
+export * from './events.js';
+export * from './create-agent-service.js';
+//# sourceMappingURL=index.js.map

package/dist/service/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/service/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,2BAA2B,CAAC"}

package/dist/service/runtime-adapter.d.ts

@@ -0,0 +1,4 @@
+import { type DevRuntime } from '@gt-fe/eap-runtime';
+import type { PreparedAgentRuntime } from '../materialization/index.js';
+export declare function createRuntimeForPrepared(_prepared: PreparedAgentRuntime, environment: Record<string, string>): DevRuntime;
+//# sourceMappingURL=runtime-adapter.d.ts.map

package/dist/service/runtime-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-adapter.d.ts","sourceRoot":"","sources":["../../src/service/runtime-adapter.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,UAAU,EAChB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AAExE,wBAAgB,wBAAwB,CACtC,SAAS,EAAE,oBAAoB,EAC/B,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAClC,UAAU,CAGZ"}

package/dist/service/runtime-adapter.js

@@ -0,0 +1,6 @@
+import { createDevRuntime, } from '@gt-fe/eap-runtime';
+export function createRuntimeForPrepared(_prepared, environment) {
+    Object.assign(process.env, environment);
+    return createDevRuntime();
+}
+//# sourceMappingURL=runtime-adapter.js.map

package/dist/service/runtime-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-adapter.js","sourceRoot":"","sources":["../../src/service/runtime-adapter.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,gBAAgB,GAEjB,MAAM,oBAAoB,CAAC;AAG5B,MAAM,UAAU,wBAAwB,CACtC,SAA+B,EAC/B,WAAmC;IAEnC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,EAAE,WAAW,CAAC,CAAC;IACxC,OAAO,gBAAgB,EAAE,CAAC;AAC5B,CAAC"}

package/dist/service/types.d.ts

@@ -0,0 +1,48 @@
+import type { DevRuntime, ExecuteParams, GraphMessage } from '@gt-fe/eap-runtime';
+import type { ResolvedAgentProject } from '../discovery/index.js';
+import type { PreparedAgentRuntime } from '../materialization/index.js';
+import type { AgentProjectSelector } from '../schema/index.js';
+import type { AgentServiceStreamEvent } from './events.js';
+export type AgentServiceRequest = Omit<ExecuteParams, 'agentCode' | 'input'>;
+export type AgentServiceStream = AsyncIterable<AgentServiceStreamEvent>;
+export type AgentServiceInvokeResult = ReturnType<DevRuntime['agentRuntime']['execute']>;
+export interface AgentServiceStartOptions {
+    host?: string;
+    port?: number;
+}
+export type AgentRuntimeFactory = (prepared: PreparedAgentRuntime, environment: Record<string, string>) => DevRuntime;
+export type CreateAgentServiceOptions = AgentProjectSelector & {
+    runtimeFactory?: AgentRuntimeFactory;
+    messages?: GraphMessage[];
+    /**
+     * Enable file-backed Runtime sessions, messages, and checkpoints.
+     *
+     * SDK services default to in-memory storage so embedding an Agent does not
+     * create local conversation files. The CLI development surfaces opt in.
+     */
+    sessionPersistence?: boolean;
+};
+/**
+ * Starts an Agent from a previously materialized Runtime tree. This is the
+ * production counterpart to createAgentService(): it never reads project
+ * source files or performs materialization.
+ */
+export interface CreateEmbeddedAgentServiceOptions {
+    runtimeRoot: string;
+    agentCode?: string;
+    version?: string;
+    runtimeFactory?: AgentRuntimeFactory;
+    environment?: Record<string, string>;
+    deploymentContext?: 'dev' | 'desktop' | 'server';
+    sessionPersistence?: boolean;
+    sessionDirectory?: string;
+}
+export interface AgentService {
+    readonly target: ResolvedAgentProject;
+    readonly runtime: DevRuntime;
+    invoke(input: string, options?: AgentServiceRequest): AgentServiceInvokeResult;
+    stream(input: string, options?: AgentServiceRequest): AgentServiceStream;
+    start(options: AgentServiceStartOptions): Promise<void>;
+    stop(): Promise<void>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/service/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/service/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClF,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAClE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACxE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC/D,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC;AAE3D,MAAM,MAAM,mBAAmB,GAAG,IAAI,CAAC,aAAa,EAAE,WAAW,GAAG,OAAO,CAAC,CAAC;AAC7E,MAAM,MAAM,kBAAkB,GAAG,aAAa,CAAC,uBAAuB,CAAC,CAAC;AACxE,MAAM,MAAM,wBAAwB,GAAG,UAAU,CAAC,UAAU,CAAC,cAAc,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC;AAEzF,MAAM,WAAW,wBAAwB;IACvC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,MAAM,mBAAmB,GAAG,CAChC,QAAQ,EAAE,oBAAoB,EAC9B,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,KAChC,UAAU,CAAC;AAEhB,MAAM,MAAM,yBAAyB,GAAG,oBAAoB,GAAG;IAC7D,cAAc,CAAC,EAAE,mBAAmB,CAAC;IACrC,QAAQ,CAAC,EAAE,YAAY,EAAE,CAAC;IAC1B;;;;;OAKG;IACH,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAC9B,CAAC;AAEF;;;;GAIG;AACH,MAAM,WAAW,iCAAiC;IAChD,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,cAAc,CAAC,EAAE,mBAAmB,CAAC;IACrC,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACrC,iBAAiB,CAAC,EAAE,KAAK,GAAG,SAAS,GAAG,QAAQ,CAAC;IACjD,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,MAAM,EAAE,oBAAoB,CAAC;IACtC,QAAQ,CAAC,OAAO,EAAE,UAAU,CAAC;IAC7B,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,mBAAmB,GAAG,wBAAwB,CAAC;IAC/E,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,mBAAmB,GAAG,kBAAkB,CAAC;IACzE,KAAK,CAAC,OAAO,EAAE,wBAAwB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACxD,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACvB"}

package/dist/service/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/service/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/service/types.ts"],"names":[],"mappings":""}

package/dist/validation/index.d.ts

@@ -0,0 +1,5 @@
+export * from './types.js';
+export * from './validate-graph.js';
+export * from './validate-agent-directory.js';
+export * from './validate-agent-project.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/validation/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/validation/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,qBAAqB,CAAC;AACpC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,6BAA6B,CAAC"}

package/dist/validation/index.js

@@ -0,0 +1,5 @@
+export * from './types.js';
+export * from './validate-graph.js';
+export * from './validate-agent-directory.js';
+export * from './validate-agent-project.js';
+//# sourceMappingURL=index.js.map

package/dist/validation/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/validation/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,qBAAqB,CAAC;AACpC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,6BAA6B,CAAC"}

package/dist/validation/types.d.ts

@@ -0,0 +1,23 @@
+import type { AgentManifest, Graph } from '../schema/index.js';
+import type { ResolvedAgentProject } from '../discovery/index.js';
+export interface ValidationIssue {
+    severity: 'error' | 'warning';
+    code: string;
+    message: string;
+    filePath?: string;
+    jsonPath?: string;
+    agentCode?: string;
+    version?: string;
+}
+export interface ValidatedAgentProject {
+    project: ResolvedAgentProject;
+    manifest: AgentManifest;
+    graph: Graph;
+}
+export interface AgentProjectValidationResult {
+    root: string;
+    valid: boolean;
+    issues: ValidationIssue[];
+    agent?: ValidatedAgentProject;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/validation/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/validation/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAC/D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAElE,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,OAAO,GAAG,SAAS,CAAC;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,oBAAoB,CAAC;IAC9B,QAAQ,EAAE,aAAa,CAAC;IACxB,KAAK,EAAE,KAAK,CAAC;CACd;AAED,MAAM,WAAW,4BAA4B;IAC3C,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,eAAe,EAAE,CAAC;IAC1B,KAAK,CAAC,EAAE,qBAAqB,CAAC;CAC/B"}

package/dist/validation/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/validation/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/validation/types.ts"],"names":[],"mappings":""}

package/dist/validation/validate-agent-directory.d.ts

@@ -0,0 +1,8 @@
+import type { ResolvedAgentProject } from '../discovery/index.js';
+import type { ValidatedAgentProject, ValidationIssue } from './types.js';
+export interface AgentDirectoryValidationResult {
+    issues: ValidationIssue[];
+    agent?: ValidatedAgentProject;
+}
+export declare function validateAgentDirectory(project: ResolvedAgentProject): AgentDirectoryValidationResult;
+//# sourceMappingURL=validate-agent-directory.d.ts.map

package/dist/validation/validate-agent-directory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-agent-directory.d.ts","sourceRoot":"","sources":["../../src/validation/validate-agent-directory.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAElE,OAAO,KAAK,EAAE,qBAAqB,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAEzE,MAAM,WAAW,8BAA8B;IAC7C,MAAM,EAAE,eAAe,EAAE,CAAC;IAC1B,KAAK,CAAC,EAAE,qBAAqB,CAAC;CAC/B;AAED,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,oBAAoB,GAAG,8BAA8B,CAmDpG"}

package/dist/validation/validate-agent-directory.js

@@ -0,0 +1,82 @@
+import { existsSync, readFileSync, readdirSync } from 'node:fs';
+import { resolve } from 'node:path';
+import { AgentManifestSchema } from '../schema/index.js';
+import { validateGraph } from './validate-graph.js';
+export function validateAgentDirectory(project) {
+    const issues = [];
+    const manifestJson = readJson(project.manifestPath, 'agent.manifest.json', issues, project);
+    const graphJson = readJson(project.graphPath, 'graph.json', issues, project);
+    if (manifestJson === undefined || graphJson === undefined)
+        return { issues };
+    const manifest = AgentManifestSchema.safeParse(manifestJson);
+    if (!manifest.success) {
+        issues.push(...manifest.error.issues.map((issue) => ({
+            severity: 'error',
+            code: 'agent_manifest.schema.invalid',
+            message: issue.message,
+            filePath: project.manifestPath,
+            jsonPath: issue.path.join('.'),
+            agentCode: project.agentCode,
+            version: project.version,
+        })));
+        return { issues };
+    }
+    if (manifest.data.code !== project.agentCode || manifest.data.version !== project.version) {
+        issues.push({
+            severity: 'error',
+            code: 'agent_manifest.identity_mismatch',
+            message: `Manifest identity must match ${project.agentCode}@${project.version}`,
+            filePath: project.manifestPath,
+            agentCode: project.agentCode,
+            version: project.version,
+        });
+    }
+    for (const name of readdirSync(project.root)) {
+        if ((name === 'graph.yaml' || name === 'graph.yml') || (name.startsWith('graph.') && name !== 'graph.json')) {
+            issues.push({
+                severity: 'error',
+                code: 'agent_graph.unsupported_file',
+                message: `Only graph.json is supported; found ${name}`,
+                filePath: resolve(project.root, name),
+                agentCode: project.agentCode,
+                version: project.version,
+            });
+        }
+    }
+    const graphResult = validateGraph(graphJson, project.graphPath, manifest.data);
+    issues.push(...graphResult.issues.map((issue) => ({ ...issue, agentCode: project.agentCode, version: project.version })));
+    if (!graphResult.graph || issues.some((issue) => issue.severity === 'error'))
+        return { issues };
+    return {
+        issues,
+        agent: { project, manifest: manifest.data, graph: graphResult.graph },
+    };
+}
+function readJson(path, label, issues, project) {
+    if (!existsSync(path)) {
+        issues.push({
+            severity: 'error',
+            code: 'agent_project.file_missing',
+            message: `Missing ${label}`,
+            filePath: path,
+            agentCode: project.agentCode,
+            version: project.version,
+        });
+        return undefined;
+    }
+    try {
+        return JSON.parse(readFileSync(path, 'utf8'));
+    }
+    catch (error) {
+        issues.push({
+            severity: 'error',
+            code: 'agent_project.invalid_json',
+            message: error instanceof Error ? error.message : String(error),
+            filePath: path,
+            agentCode: project.agentCode,
+            version: project.version,
+        });
+        return undefined;
+    }
+}
+//# sourceMappingURL=validate-agent-directory.js.map

package/dist/validation/validate-agent-directory.js.map

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

package/dist/validation/validate-agent-project.d.ts

@@ -0,0 +1,3 @@
+import type { AgentProjectValidationResult } from './types.js';
+export declare function validateAgentProject(root?: string): AgentProjectValidationResult;
+//# sourceMappingURL=validate-agent-project.d.ts.map

package/dist/validation/validate-agent-project.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-agent-project.d.ts","sourceRoot":"","sources":["../../src/validation/validate-agent-project.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,4BAA4B,EAAmB,MAAM,YAAY,CAAC;AAEhF,wBAAgB,oBAAoB,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,4BAA4B,CA0BhF"}

package/dist/validation/validate-agent-project.js

@@ -0,0 +1,99 @@
+import { existsSync, lstatSync } from 'node:fs';
+import { resolve } from 'node:path';
+import { loadProjectRuntimeConfig } from '../config/index.js';
+import { resolveAgentProject } from '../discovery/index.js';
+import { declaredResourceCodes, findUndeclaredLockedResources, readEapLock, resolveLockedResources, } from '../lockfile/index.js';
+import { validateAgentDirectory } from './validate-agent-directory.js';
+export function validateAgentProject(root) {
+    const project = resolveAgentProject(root ? { root } : {});
+    const result = validateAgentDirectory(project);
+    const issues = [...result.issues];
+    try {
+        loadProjectRuntimeConfig({ root: project.root });
+    }
+    catch (error) {
+        issues.push({
+            severity: 'error',
+            code: 'project_config.invalid',
+            message: error instanceof Error ? error.message : String(error),
+            filePath: resolve(project.root, 'eap.config.json'),
+            agentCode: project.agentCode,
+            version: project.version,
+        });
+    }
+    if (result.agent)
+        validateLockResources(project.root, result.agent.manifest, issues);
+    return {
+        root: project.root,
+        valid: issues.every((issue) => issue.severity !== 'error'),
+        issues,
+        ...(result.agent ? { agent: result.agent } : {}),
+    };
+}
+function validateLockResources(root, manifest, issues) {
+    const hasMaterializedDependencies = declaredResourceCodes(manifest, 'tools').length > 0
+        || declaredResourceCodes(manifest, 'skills').length > 0;
+    let lock;
+    try {
+        lock = readEapLock(root);
+    }
+    catch (error) {
+        issues.push(lockIssue('lockfile.invalid', error, resolve(root, 'eap.lock.yaml')));
+        return;
+    }
+    if (!lock) {
+        if (hasMaterializedDependencies) {
+            issues.push({
+                severity: 'error',
+                code: 'lockfile.missing',
+                message: 'eap.lock.yaml is required when Tool or Skill dependencies are declared',
+                filePath: resolve(root, 'eap.lock.yaml'),
+                agentCode: manifest.code,
+                version: manifest.version,
+            });
+        }
+        return;
+    }
+    try {
+        const resources = resolveLockedResources({ root, manifest, lock });
+        for (const resource of resources) {
+            if (resource.source !== 'registry')
+                continue;
+            const localPath = resolve(root, resource.kind, resource.code);
+            if (existsSync(localPath) && lstatSync(localPath).isDirectory()) {
+                issues.push({
+                    severity: 'error',
+                    code: 'lockfile.local_registry_conflict',
+                    message: `Registry ${resource.kind.slice(0, -1)} ${resource.code} conflicts with local directory ${localPath}`,
+                    filePath: localPath,
+                    agentCode: manifest.code,
+                    version: manifest.version,
+                });
+            }
+        }
+    }
+    catch (error) {
+        issues.push(lockIssue('lockfile.invalid_resource', error, resolve(root, 'eap.lock.yaml'), manifest.code, manifest.version));
+    }
+    for (const resource of findUndeclaredLockedResources(manifest, lock)) {
+        issues.push({
+            severity: 'warning',
+            code: 'lockfile.undeclared_resource',
+            message: `Locked ${resource.kind.slice(0, -1)} ${resource.code}@${resource.version} is not declared by agent.manifest.json`,
+            filePath: resolve(root, 'eap.lock.yaml'),
+            agentCode: manifest.code,
+            version: manifest.version,
+        });
+    }
+}
+function lockIssue(code, error, filePath, agentCode, version) {
+    return {
+        severity: 'error',
+        code,
+        message: error instanceof Error ? error.message : String(error),
+        filePath,
+        agentCode,
+        version,
+    };
+}
+//# sourceMappingURL=validate-agent-project.js.map

package/dist/validation/validate-agent-project.js.map

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

package/dist/validation/validate-graph.d.ts

@@ -0,0 +1,8 @@
+import type { AgentManifest, Graph } from '../schema/index.js';
+import type { ValidationIssue } from './types.js';
+export interface GraphValidationResult {
+    graph?: Graph;
+    issues: ValidationIssue[];
+}
+export declare function validateGraph(value: unknown, filePath: string, manifest?: AgentManifest): GraphValidationResult;
+//# sourceMappingURL=validate-graph.d.ts.map

package/dist/validation/validate-graph.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-graph.d.ts","sourceRoot":"","sources":["../../src/validation/validate-graph.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAE/D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAElD,MAAM,WAAW,qBAAqB;IACpC,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,MAAM,EAAE,eAAe,EAAE,CAAC;CAC3B;AAED,wBAAgB,aAAa,CAC3B,KAAK,EAAE,OAAO,EACd,QAAQ,EAAE,MAAM,EAChB,QAAQ,CAAC,EAAE,aAAa,GACvB,qBAAqB,CAsFvB"}

package/dist/validation/validate-graph.js

@@ -0,0 +1,127 @@
+import { GraphSchema } from '../schema/index.js';
+export function validateGraph(value, filePath, manifest) {
+    const parsed = GraphSchema.safeParse(value);
+    if (!parsed.success) {
+        return {
+            issues: parsed.error.issues.map((issue) => ({
+                severity: 'error',
+                code: 'graph.schema.invalid',
+                message: issue.message,
+                filePath,
+                jsonPath: toJsonPath(issue.path),
+            })),
+        };
+    }
+    const graph = parsed.data;
+    const issues = [];
+    const nodeIds = new Set();
+    for (const [index, node] of graph.nodes.entries()) {
+        if (nodeIds.has(node.id)) {
+            issues.push(error('graph.duplicate_node_id', `Duplicate node id: ${node.id}`, filePath, `nodes[${index}].id`));
+        }
+        nodeIds.add(node.id);
+    }
+    const validEndpoint = (id) => id === '__start__' || id === '__end__' || nodeIds.has(id);
+    const adjacency = new Map();
+    for (const id of nodeIds)
+        adjacency.set(id, new Set());
+    const addEdge = (from, to, path) => {
+        if (!validEndpoint(from))
+            issues.push(error('graph.invalid_edge_from', `Unknown edge source: ${from}`, filePath, `${path}.from`));
+        if (!validEndpoint(to))
+            issues.push(error('graph.invalid_edge_to', `Unknown edge target: ${to}`, filePath, `${path}.to`));
+        if (nodeIds.has(from) && nodeIds.has(to))
+            adjacency.get(from).add(to);
+    };
+    graph.edges.forEach((edge, index) => addEdge(edge.from, edge.to, `edges[${index}]`));
+    graph.conditionalEdges?.forEach((edge, index) => {
+        if (!nodeIds.has(edge.from)) {
+            issues.push(error('graph.invalid_conditional_source', `Unknown conditional source: ${edge.from}`, filePath, `conditionalEdges[${index}].from`));
+        }
+        edge.branches.forEach((branch, branchIndex) => {
+            addEdge(edge.from, branch.to, `conditionalEdges[${index}].branches[${branchIndex}]`);
+        });
+        if (edge.fallback)
+            addEdge(edge.from, edge.fallback, `conditionalEdges[${index}].fallback`);
+    });
+    const startNodes = new Set();
+    if (graph.entryPoint) {
+        if (!nodeIds.has(graph.entryPoint)) {
+            issues.push(error('graph.invalid_entry_point', `Unknown entry point: ${graph.entryPoint}`, filePath, 'entryPoint'));
+        }
+        else {
+            startNodes.add(graph.entryPoint);
+        }
+    }
+    else {
+        for (const edge of graph.edges) {
+            if (edge.from === '__start__' && nodeIds.has(edge.to))
+                startNodes.add(edge.to);
+        }
+        if (startNodes.size === 0) {
+            issues.push(error('graph.missing_entry_point', 'Graph requires entryPoint or an edge from __start__', filePath));
+        }
+    }
+    if (graph.finishPoints?.length) {
+        graph.finishPoints.forEach((finishPoint, index) => {
+            if (finishPoint !== '__end__' && !nodeIds.has(finishPoint)) {
+                issues.push(error('graph.invalid_finish_point', `Unknown finish point: ${finishPoint}`, filePath, `finishPoints[${index}]`));
+            }
+        });
+    }
+    else if (!graph.edges.some((edge) => edge.to === '__end__')) {
+        issues.push(error('graph.missing_finish_point', 'Graph requires finishPoints or an edge to __end__', filePath));
+    }
+    const reachable = new Set();
+    const pending = [...startNodes];
+    while (pending.length > 0) {
+        const nodeId = pending.pop();
+        if (reachable.has(nodeId))
+            continue;
+        reachable.add(nodeId);
+        for (const next of adjacency.get(nodeId) ?? [])
+            pending.push(next);
+    }
+    for (const nodeId of nodeIds) {
+        if (!reachable.has(nodeId)) {
+            issues.push(error('graph.unreachable_node', `Node is unreachable: ${nodeId}`, filePath, `nodes[${graph.nodes.findIndex((node) => node.id === nodeId)}]`));
+        }
+    }
+    if (manifest)
+        validateManifestReferences(graph, manifest, filePath, issues);
+    return { graph, issues };
+}
+function validateManifestReferences(graph, manifest, filePath, issues) {
+    const toolRefs = graph.nodes
+        .filter((node) => node.type === 'tool')
+        .map((node) => node.config.tool);
+    for (const tool of toolRefs) {
+        // A Toolset intentionally stays opaque in the SDK. Runtime expands its
+        // tools[] entries, so their names cannot be checked here without crossing
+        // the module boundary.
+        if (manifest.toolRefs.length === 0) {
+            issues.push(error('graph.undeclared_tool', `Graph Tool ${tool} is not declared in agent.manifest.json`, filePath));
+        }
+    }
+    const skillRefs = graph.nodes
+        .filter((node) => node.type === 'subgraph')
+        .flatMap((node) => {
+        const skill = node.config.skillId ?? node.config.skillCode ?? node.subgraphId;
+        return skill ? [skill] : [];
+    });
+    for (const skill of skillRefs) {
+        const declaredSkills = new Set(manifest.skillRefs.flatMap((ref) => ref.skill ?? ref.skillId ?? []));
+        if (!declaredSkills.has(skill)) {
+            issues.push(error('graph.undeclared_skill', `Graph Skill ${skill} is not declared in agent.manifest.json`, filePath));
+        }
+    }
+}
+function error(code, message, filePath, jsonPath) {
+    return { severity: 'error', code, message, filePath, jsonPath };
+}
+function toJsonPath(path) {
+    if (path.length === 0)
+        return undefined;
+    return path.map((segment) => typeof segment === 'number' ? `[${segment}]` : segment).join('.').replace('.[', '[');
+}
+//# sourceMappingURL=validate-graph.js.map