@gt-fe/eap-sdk 0.1.13 → 0.2.0

package/dist/service/resources.d.ts

@@ -0,0 +1,86 @@
+export type ResourceKind = 'tool' | 'skill';
+export type ResourceSource = 'bundled' | 'remote';
+export interface ResourceRef {
+    kind: ResourceKind;
+    code: string;
+    version: string;
+}
+export interface ResourceQuery {
+    kind?: ResourceKind;
+    code?: string;
+    source?: ResourceSource;
+    desiredState?: 'enabled' | 'disabled' | 'uninstalled';
+    effectiveState?: 'enabled' | 'disabled' | 'uninstalled' | 'pending';
+}
+export interface ResourceError {
+    code: string;
+    message: string;
+}
+export interface AgentResourceState extends ResourceRef {
+    source: ResourceSource;
+    name?: string;
+    digest: string;
+    desiredState: 'enabled' | 'disabled' | 'uninstalled';
+    effectiveState: 'enabled' | 'disabled' | 'uninstalled' | 'pending';
+    loadedAt?: string;
+    revision: string;
+    error?: ResourceError;
+}
+export interface ResourceCatalogItem extends ResourceRef {
+    name: string;
+    digest: string;
+    description?: string;
+    installed: boolean;
+    enabled?: boolean;
+}
+export interface ResourceMutationOptions {
+    expectedRevision?: string;
+    idempotencyKey?: string;
+}
+export interface ResourceActivationOptions extends ResourceMutationOptions {
+}
+export interface InstallResourceRequest extends ResourceMutationOptions {
+    ref: ResourceRef;
+    enabled?: boolean;
+}
+export interface RefreshResourceRequest extends ResourceMutationOptions {
+    ref?: ResourceRef;
+    kind?: ResourceKind;
+    code?: string;
+}
+export interface ResourceApplyOptions {
+    resources?: ResourceRef[];
+    /** Set false to only materialize desired state without reloading the Agent. */
+    reload?: boolean;
+}
+export interface ResourceChangeResult {
+    ref: ResourceRef;
+    status: 'pending' | 'effective' | 'failed';
+    desiredRevision: string;
+    effectiveRevision?: string;
+    requiresReload: boolean;
+    error?: ResourceError;
+}
+/**
+ * Adapter owned by the embedding host. The SDK intentionally stores no
+ * resource database and never writes CLI manifest or lock files for it.
+ */
+export interface AgentResourceManager {
+    listMarket(query?: ResourceQuery): Promise<ResourceCatalogItem[]>;
+    listInstalled(query?: ResourceQuery): Promise<AgentResourceState[]>;
+    get(ref: ResourceRef): Promise<AgentResourceState | null>;
+    install(request: InstallResourceRequest): Promise<ResourceChangeResult>;
+    uninstall(ref: ResourceRef, options?: ResourceMutationOptions): Promise<ResourceChangeResult>;
+    refresh(request?: RefreshResourceRequest): Promise<ResourceChangeResult[]>;
+    enable(ref: ResourceRef, options?: ResourceActivationOptions): Promise<ResourceChangeResult>;
+    disable(ref: ResourceRef, options?: ResourceActivationOptions): Promise<ResourceChangeResult>;
+    apply(options?: ResourceApplyOptions): Promise<ResourceChangeResult>;
+    invalidate(ref?: ResourceRef): Promise<void>;
+}
+export declare class ResourceManagerUnavailableError extends Error {
+    readonly code = "resource_manager_unavailable";
+    readonly status = 501;
+    constructor();
+}
+export declare function createUnavailableResourceManager(): AgentResourceManager;
+//# sourceMappingURL=resources.d.ts.map

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

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

package/dist/service/resources.js

@@ -0,0 +1,26 @@
+export class ResourceManagerUnavailableError extends Error {
+    code = 'resource_manager_unavailable';
+    status = 501;
+    constructor() {
+        super('No embedded resource manager was configured');
+        this.name = 'ResourceManagerUnavailableError';
+    }
+}
+export function createUnavailableResourceManager() {
+    const unavailable = async () => {
+        throw new ResourceManagerUnavailableError();
+    };
+    return {
+        listMarket: unavailable,
+        listInstalled: unavailable,
+        get: unavailable,
+        install: unavailable,
+        uninstall: unavailable,
+        refresh: unavailable,
+        enable: unavailable,
+        disable: unavailable,
+        apply: unavailable,
+        invalidate: unavailable,
+    };
+}
+//# sourceMappingURL=resources.js.map

package/dist/service/resources.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resources.js","sourceRoot":"","sources":["../../src/service/resources.ts"],"names":[],"mappings":"AA2FA,MAAM,OAAO,+BAAgC,SAAQ,KAAK;IAC/C,IAAI,GAAG,8BAA8B,CAAC;IACtC,MAAM,GAAG,GAAG,CAAC;IAEtB;QACE,KAAK,CAAC,6CAA6C,CAAC,CAAC;QACrD,IAAI,CAAC,IAAI,GAAG,iCAAiC,CAAC;IAChD,CAAC;CACF;AAED,MAAM,UAAU,gCAAgC;IAC9C,MAAM,WAAW,GAAG,KAAK,IAAoB,EAAE;QAC7C,MAAM,IAAI,+BAA+B,EAAE,CAAC;IAC9C,CAAC,CAAC;IACF,OAAO;QACL,UAAU,EAAE,WAAW;QACvB,aAAa,EAAE,WAAW;QAC1B,GAAG,EAAE,WAAW;QAChB,OAAO,EAAE,WAAW;QACpB,SAAS,EAAE,WAAW;QACtB,OAAO,EAAE,WAAW;QACpB,MAAM,EAAE,WAAW;QACnB,OAAO,EAAE,WAAW;QACpB,KAAK,EAAE,WAAW;QAClB,UAAU,EAAE,WAAW;KACxB,CAAC;AACJ,CAAC"}

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

@@ -1 +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"}
+{"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,CAuBZ"}

package/dist/service/runtime-adapter.js

@@ -1,6 +1,30 @@
 import { createDevRuntime, } from '@gt-fe/eap-runtime';
 export function createRuntimeForPrepared(_prepared, environment) {
-    Object.assign(process.env, environment);
-    return createDevRuntime();
+    const previous = new Map();
+    const serverSensitiveKeys = environment.EAP_DEPLOYMENT_CONTEXT === 'server'
+        ? ['EAP_TOKEN', 'EAP_DELEGATION_TOKEN', 'OPENAI_API_KEY']
+        : [];
+    for (const key of serverSensitiveKeys) {
+        previous.set(key, process.env[key]);
+        delete process.env[key];
+    }
+    for (const [key, value] of Object.entries(environment)) {
+        if (!previous.has(key))
+            previous.set(key, process.env[key]);
+        process.env[key] = value;
+    }
+    try {
+        // Runtime currently reads its assembly settings from process.env. Restore
+        // immediately after construction so embedded Agent configuration is scoped.
+        return createDevRuntime();
+    }
+    finally {
+        for (const [key, value] of previous) {
+            if (value === undefined)
+                delete process.env[key];
+            else
+                process.env[key] = value;
+        }
+    }
 }
 //# sourceMappingURL=runtime-adapter.js.map

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

@@ -1 +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"}
+{"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,QAAQ,GAAG,IAAI,GAAG,EAA8B,CAAC;IACvD,MAAM,mBAAmB,GAAG,WAAW,CAAC,sBAAsB,KAAK,QAAQ;QACzE,CAAC,CAAC,CAAC,WAAW,EAAE,sBAAsB,EAAE,gBAAgB,CAAC;QACzD,CAAC,CAAC,EAAE,CAAC;IACP,KAAK,MAAM,GAAG,IAAI,mBAAmB,EAAE,CAAC;QACtC,QAAQ,CAAC,GAAG,CAAC,GAAG,EAAE,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;QACpC,OAAO,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC1B,CAAC;IACD,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,CAAC;QACvD,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC;YAAE,QAAQ,CAAC,GAAG,CAAC,GAAG,EAAE,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;QAC5D,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;IAC3B,CAAC;IACD,IAAI,CAAC;QACH,0EAA0E;QAC1E,4EAA4E;QAC5E,OAAO,gBAAgB,EAAE,CAAC;IAC5B,CAAC;YAAS,CAAC;QACT,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,QAAQ,EAAE,CAAC;YACpC,IAAI,KAAK,KAAK,SAAS;gBAAE,OAAO,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;;gBAC5C,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;QAChC,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/service/sessions.d.ts

@@ -0,0 +1,33 @@
+import type { DevRuntime, SessionRecord } from '@gt-fe/eap-runtime';
+export interface Page<T> {
+    items: T[];
+    limit: number;
+    offset: number;
+    total?: number;
+}
+export interface CreateSessionInput {
+    id?: string;
+    userId?: string;
+    title?: string;
+    metadata?: Record<string, unknown>;
+}
+export interface SessionListQuery {
+    userId?: string;
+    limit?: number;
+    offset?: number;
+}
+export type SessionView = SessionRecord;
+export declare class SessionCapabilityError extends Error {
+    readonly code = "not_supported";
+    readonly status = 501;
+    constructor(message?: string);
+}
+export interface AgentSessionManager {
+    create(input?: CreateSessionInput): Promise<SessionView>;
+    get(sessionId: string): Promise<SessionView | null>;
+    list(query?: SessionListQuery): Promise<Page<SessionView>>;
+    restore(sessionId: string): Promise<SessionView>;
+    archive(sessionId: string): Promise<SessionView>;
+}
+export declare function createSessionManager(getRuntime: () => DevRuntime, agentCode: string, defaultUserId?: string): AgentSessionManager;
+//# sourceMappingURL=sessions.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sessions.d.ts","sourceRoot":"","sources":["../../src/service/sessions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEpE,MAAM,WAAW,IAAI,CAAC,CAAC;IACrB,KAAK,EAAE,CAAC,EAAE,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,kBAAkB;IACjC,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED,MAAM,WAAW,gBAAgB;IAC/B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,MAAM,WAAW,GAAG,aAAa,CAAC;AAExC,qBAAa,sBAAuB,SAAQ,KAAK;IAC/C,QAAQ,CAAC,IAAI,mBAAmB;IAChC,QAAQ,CAAC,MAAM,OAAO;gBAEV,OAAO,SAA4D;CAIhF;AAED,MAAM,WAAW,mBAAmB;IAClC,MAAM,CAAC,KAAK,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IACzD,GAAG,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC;IACpD,IAAI,CAAC,KAAK,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC;IAC3D,OAAO,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IACjD,OAAO,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;CAClD;AAED,wBAAgB,oBAAoB,CAClC,UAAU,EAAE,MAAM,UAAU,EAC5B,SAAS,EAAE,MAAM,EACjB,aAAa,SAAiB,GAC7B,mBAAmB,CAmCrB"}

package/dist/service/sessions.js

@@ -0,0 +1,67 @@
+export class SessionCapabilityError extends Error {
+    code = 'not_supported';
+    status = 501;
+    constructor(message = 'Session restore is not supported by the current Runtime') {
+        super(message);
+        this.name = 'SessionCapabilityError';
+    }
+}
+export function createSessionManager(getRuntime, agentCode, defaultUserId = 'default-user') {
+    return {
+        async create(input = {}) {
+            const userId = input.userId?.trim() || defaultUserId;
+            return getRuntime().sessionService.createSession({
+                ...(input.id ? { id: input.id } : {}),
+                userId,
+                agentId: agentCode,
+                ...(input.title !== undefined ? { title: input.title } : {}),
+                ...(input.metadata !== undefined ? { metadata: input.metadata } : {}),
+            });
+        },
+        async get(sessionId) {
+            return getRuntime().sessionService.findSession(sessionId);
+        },
+        async list(query = {}) {
+            const limit = normalizePageSize(query.limit);
+            const offset = normalizeOffset(query.offset);
+            const service = getRuntime().sessionService;
+            const items = query.userId
+                ? await service.listSessions(query.userId, { limit, offset })
+                : await listAllOrPage(service, limit, offset);
+            return { items, limit, offset };
+        },
+        async restore(_sessionId) {
+            throw new SessionCapabilityError();
+        },
+        async archive(sessionId) {
+            const service = getRuntime().sessionService;
+            await service.archiveSession(sessionId);
+            const session = await service.findSession(sessionId);
+            if (!session)
+                throw new Error(`Session not found: ${sessionId}`);
+            return session;
+        },
+    };
+}
+async function listAllOrPage(service, limit, offset) {
+    if (typeof service.listAllSessions === 'function') {
+        const all = await service.listAllSessions();
+        return all.slice(offset, offset + limit);
+    }
+    return service.listSessions('default-user', { limit, offset });
+}
+function normalizePageSize(value) {
+    if (value === undefined)
+        return 50;
+    if (!Number.isInteger(value) || value < 1 || value > 500)
+        throw new RangeError('Session limit must be an integer between 1 and 500');
+    return value;
+}
+function normalizeOffset(value) {
+    if (value === undefined)
+        return 0;
+    if (!Number.isInteger(value) || value < 0)
+        throw new RangeError('Session offset must be a non-negative integer');
+    return value;
+}
+//# sourceMappingURL=sessions.js.map

package/dist/service/sessions.js.map

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

package/dist/service/types.d.ts

@@ -1,54 +1,143 @@
-import type { ConversationDetail, DevRuntime, ExecuteParams, GraphMessage, LlmTurnIndexEntry, LlmTurnRecord, SessionRecord } from '@gt-fe/eap-runtime';
+import type { ConversationDetail, DevRuntime, ExecuteParams, GraphDSL as RuntimeGraphDSL, LlmTurnIndexEntry, LlmTurnRecord, MessageRecord, SSEEvent, SessionRecord } 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[];
+import type { AgentEventManager } from './events.js';
+import type { AgentMessageManager } from './messages.js';
+import type { AgentResourceManager } from './resources.js';
+import type { AgentSessionManager } from './sessions.js';
+export type AgentEventHandler = (event: SSEEvent) => void | Promise<void>;
+/** Request options accepted by both invoke and stream. */
+export type AgentRequest = Omit<ExecuteParams, 'agentCode' | 'input'> & {
+    /** Receives the same Runtime SSEEvent values yielded by stream(). */
+    onEvent?: AgentEventHandler;
+    /** Event callback errors are ignored by default so Runtime results are unchanged. */
+    onEventError?: 'ignore' | 'throw';
     /**
-     * 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.
+     * RAG 会话勾选的数据源 id 列表。
+     * undefined = 目录全部启用（缺省）；[] = 全不勾（外部源全拒；声明过 local-file 未勾 → 本地关闭）。
+     * TODO(runtime): 最新 @gt-fe/eap-runtime 尚未在 ExecuteParams 上发布该字段，
+     * 暂由 SDK 在 AgentRequest 补齐并随 execute/stream 透传；待 runtime 更新后迁移到 ExecuteParams 并移除 SDK 侧声明。
      */
-    sessionPersistence?: boolean;
+    ragSources?: string[];
+    /**
+     * RAG 本地检索范围（只作用本地源）。
+     * dirPaths 按目录整棵圈定（含子目录）；fileIds 与 dirPaths 取并集；fileIds: [] 显式关本地（引擎回空）。
+     * TODO(runtime): 最新 @gt-fe/eap-runtime 尚未在 ExecuteParams 上发布该字段，
+     * 暂由 SDK 在 AgentRequest 补齐并随 execute/stream 透传；待 runtime 更新后迁移到 ExecuteParams 并移除 SDK 侧声明。
+     */
+    ragScope?: {
+        fileIds?: string[];
+        dirPaths?: string[];
+    };
 };
-/**
- * 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;
+export type AgentStream = AsyncIterable<SSEEvent>;
+export type AgentInvokeResult = ReturnType<DevRuntime['agentRuntime']['execute']>;
+export interface CredentialToken {
+    value: string;
+    expiresAt?: string;
+    subject?: string;
+    scopes?: string[];
+}
+export interface AgentCredentialProvider {
+    getToken(input: {
+        audience: 'portal' | 'foundation' | 'runtime';
+        agentCode: string;
+        requestId?: string;
+        signal?: AbortSignal;
+    }): Promise<CredentialToken>;
+    invalidate?(input: {
+        audience: string;
+        reason: 'expired' | 'unauthorized' | 'revoked';
+    }): Promise<void> | void;
+}
+export interface EmbeddedSdkConfig {
+    platform?: {
+        portalEndpoint?: string;
+        foundationEndpoint?: string;
+    };
+    credentials: {
+        provider?: AgentCredentialProvider;
+        /** Development-only token. It is rejected for server deployments. */
+        developmentToken?: string;
+    };
+    resources?: {
+        manager: AgentResourceManager;
+    };
+    runtime?: {
+        environment?: Record<string, string>;
+        /** An already authenticated runtime adapter may be used in server mode. */
+        authenticated?: boolean;
+    };
+}
+export interface ReloadResult {
+    status: 'effective' | 'failed';
+    revision: string;
+    error?: {
+        code: string;
+        message: string;
+    };
+}
+export interface ConfigWriteResult {
+    revision: string;
+    status: 'pending' | 'effective';
+    requiresReload: boolean;
+}
+export interface RuntimeConfigView {
+    revision: string;
+    pending: boolean;
+    environment: Readonly<Record<string, string>>;
+}
+export interface RuntimeConfigPatch {
+    environment?: Record<string, string>;
+    [key: string]: unknown;
+}
+export interface AgentConfigApi {
+    read(): RuntimeConfigView;
+    write(patch: RuntimeConfigPatch): Promise<ConfigWriteResult>;
+    apply(): Promise<ReloadResult>;
+}
+export type AgentRuntimeFactory = (prepared: PreparedAgentRuntime, environment: Record<string, string>) => DevRuntime;
+export interface CreateAgentOptions {
+    /** 已物化的 Runtime 根目录；缺省读取 EAP_RUNTIME_ROOT 或 dist/.eap/runtime。 */
+    runtimeRoot?: string;
     agentCode?: string;
     version?: string;
     runtimeFactory?: AgentRuntimeFactory;
+    sessionPersistence?: boolean;
     environment?: Record<string, string>;
     deploymentContext?: 'dev' | 'desktop' | 'server';
-    sessionPersistence?: boolean;
     sessionDirectory?: string;
+    embeddedConfig?: EmbeddedSdkConfig;
+}
+export interface AgentGraphApi {
+    read(): RuntimeGraphDSL;
+    replace(graph: RuntimeGraphDSL): Promise<ConfigWriteResult>;
+    update(updater: (graph: RuntimeGraphDSL) => RuntimeGraphDSL | void | Promise<RuntimeGraphDSL | void>): Promise<ConfigWriteResult>;
 }
-export interface AgentService {
+/** Runtime-backed Agent API. It does not start an HTTP server. */
+export interface Agent {
     readonly target: ResolvedAgentProject;
     readonly runtime: DevRuntime;
-    invoke(input: string, options?: AgentServiceRequest): AgentServiceInvokeResult;
-    stream(input: string, options?: AgentServiceRequest): AgentServiceStream;
+    readonly graph: AgentGraphApi;
+    readonly config: AgentConfigApi;
+    readonly resources: AgentResourceManager;
+    readonly sessions: AgentSessionManager;
+    readonly messages: AgentMessageManager;
+    readonly events: AgentEventManager;
+    readonly credentials?: AgentCredentialProvider;
+    invoke(input: string, options?: AgentRequest): AgentInvokeResult;
+    stream(input: string, options?: AgentRequest): AgentStream;
     getConversation(sessionId: string): Promise<ConversationDetail>;
     listConversations(options?: {
         userId?: string;
     }): Promise<SessionRecord[]>;
     listLlmTurns(sessionId: string): Promise<LlmTurnIndexEntry[]>;
     getLlmTurn(sessionId: string, turnId: string): Promise<LlmTurnRecord | null>;
-    start(options: AgentServiceStartOptions): Promise<void>;
-    stop(): Promise<void>;
+    reload(): Promise<ReloadResult>;
+    dispose(): void;
 }
+export type AgentFacade = Agent;
+export type CodeAgentFacade = Agent;
+export type GraphAgentFacade = Agent;
+export type { ConversationDetail, MessageRecord, RuntimeGraphDSL, SSEEvent, SessionRecord };
 //# sourceMappingURL=types.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/service/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,kBAAkB,EAClB,UAAU,EACV,aAAa,EACb,YAAY,EACZ,iBAAiB,EACjB,aAAa,EACb,aAAa,EACd,MAAM,oBAAoB,CAAC;AAC5B,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,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAC;IAChE,iBAAiB,CAAC,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC,CAAC;IAC3E,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAAC;IAC9D,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAAC;IAC7E,KAAK,CAAC,OAAO,EAAE,wBAAwB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACxD,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACvB"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/service/types.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gt-fe/eap-sdk",
-  "version": "0.1.13",
+  "version": "0.2.0",
   "description": "EAP Agent 开发 SDK — Runtime 开发服务、项目校验与确定性打包",
   "type": "module",
   "main": "./dist/index.js",
@@ -17,7 +17,7 @@
   ],
   "dependencies": {
     "@gt-fe/eap-contracts": "0.0.11",
-    "@gt-fe/eap-runtime": "0.0.15",
+    "@gt-fe/eap-runtime": "0.0.17",
     "yaml": "^2.9.0",
     "zod": "^3.25.76"
   },

package/dist/materialization/sync-author-resources.d.ts

@@ -1,21 +0,0 @@
-import type { PreparedAgentRuntime } from './types.js';
-export interface AuthorResourceSyncResult {
-    skills: {
-        updated: string[];
-        removed: string[];
-    };
-    tools: {
-        updated: string[];
-        removed: string[];
-    };
-}
-/**
- * 开发态：把工程作者源 `skills/`、`tools/` 对账到 Runtime 读的
- * `agents/<code>/<ver>/preinstall/{skills,tools}/`。
- *
- * 只同步 `agent.manifest.json` 引用、且已在锁文件中的资源；未引用的本地
- * 目录不会进入 `.eap/runtime`。不删除 dest 里多出来的包（Registry 物化的
- * Skill/Tool 必须保留）。热加载以 Runtime 读作者源为准。
- */
-export declare function syncAuthorResources(prepared: PreparedAgentRuntime): AuthorResourceSyncResult;
-//# sourceMappingURL=sync-author-resources.d.ts.map

package/dist/materialization/sync-author-resources.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"sync-author-resources.d.ts","sourceRoot":"","sources":["../../src/materialization/sync-author-resources.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAKvD,MAAM,WAAW,wBAAwB;IACvC,MAAM,EAAE;QAAE,OAAO,EAAE,MAAM,EAAE,CAAC;QAAC,OAAO,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;IACjD,KAAK,EAAE;QAAE,OAAO,EAAE,MAAM,EAAE,CAAC;QAAC,OAAO,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;CACjD;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,oBAAoB,GAAG,wBAAwB,CAM5F"}

package/dist/materialization/sync-author-resources.js

@@ -1,98 +0,0 @@
-import { copyFileSync, existsSync, lstatSync, mkdirSync, readdirSync, rmSync, writeFileSync } from 'node:fs';
-import { join, relative, resolve } from 'node:path';
-import { copyResourceDirectory } from './copy-resource-directory.js';
-const SKILL_CODE = /^[a-z0-9][a-z0-9-]*$/;
-const TOOL_CODE = /^[a-z0-9][a-z0-9_-]*$/;
-/**
- * 开发态：把工程作者源 `skills/`、`tools/` 对账到 Runtime 读的
- * `agents/<code>/<ver>/preinstall/{skills,tools}/`。
- *
- * 只同步 `agent.manifest.json` 引用、且已在锁文件中的资源；未引用的本地
- * 目录不会进入 `.eap/runtime`。不删除 dest 里多出来的包（Registry 物化的
- * Skill/Tool 必须保留）。热加载以 Runtime 读作者源为准。
- */
-export function syncAuthorResources(prepared) {
-    syncPromptFiles(prepared.projectRoot, prepared.agentDir);
-    return {
-        skills: syncKind(prepared.projectRoot, prepared.agentDir, 'skills', SKILL_CODE, declaredCodes(prepared, 'skills')),
-        tools: syncKind(prepared.projectRoot, prepared.agentDir, 'tools', TOOL_CODE, declaredCodes(prepared, 'tools')),
-    };
-}
-function declaredCodes(prepared, kind) {
-    return new Set(prepared.resources
-        .filter((resource) => resource.kind === kind)
-        .map((resource) => resource.code));
-}
-function syncPromptFiles(projectRoot, agentDir) {
-    const source = join(projectRoot, 'prompts');
-    if (!existsSync(source) || !isRegularDirectory(source))
-        return;
-    const dest = join(agentDir, 'prompts');
-    mkdirSync(dest, { recursive: true });
-    for (const name of readdirSync(source)) {
-        const from = join(source, name);
-        if (!lstatSync(from).isFile())
-            continue;
-        copyFileSync(from, join(dest, name));
-    }
-}
-function syncKind(projectRoot, agentDir, kind, codePattern, declaredCodes) {
-    const sourceRoot = resolve(projectRoot, kind);
-    const destRoot = resolve(agentDir, 'preinstall', kind);
-    const updated = [];
-    const removed = [];
-    if (!existsSync(sourceRoot) || !isRegularDirectory(sourceRoot)) {
-        return { updated, removed };
-    }
-    mkdirSync(destRoot, { recursive: true });
-    const sourceCodes = listCodes(sourceRoot, codePattern).filter((code) => declaredCodes.has(code));
-    for (const code of sourceCodes) {
-        const source = join(sourceRoot, code);
-        const dest = join(destRoot, code);
-        if (directoryStamp(source) === directoryStamp(dest))
-            continue;
-        rmSync(dest, { recursive: true, force: true });
-        copyResourceDirectory(source, dest);
-        writeFileSync(join(dest, '.ready'), '');
-        updated.push(code);
-    }
-    return { updated, removed };
-}
-function listCodes(root, codePattern) {
-    return readdirSync(root)
-        .filter((name) => codePattern.test(name) && isRegularDirectory(join(root, name)))
-        .sort();
-}
-function directoryStamp(root) {
-    if (!existsSync(root) || !isRegularDirectory(root))
-        return '';
-    const parts = [];
-    walkFiles(root, root, parts);
-    return parts.sort().join('\n');
-}
-function walkFiles(root, current, parts) {
-    for (const entry of readdirSync(current, { withFileTypes: true }).sort((left, right) => left.name.localeCompare(right.name))) {
-        if (entry.name === '.ready' || entry.name === '.env' || entry.name.startsWith('.env.') || entry.name.endsWith('.tmp')) {
-            continue;
-        }
-        const path = join(current, entry.name);
-        if (entry.isSymbolicLink())
-            continue;
-        if (entry.isDirectory()) {
-            if (entry.name === '.git' || entry.name === '.eap' || entry.name === 'node_modules')
-                continue;
-            walkFiles(root, path, parts);
-            continue;
-        }
-        if (!entry.isFile())
-            continue;
-        const stat = lstatSync(path);
-        const rel = relative(root, path).split(/[\\/]/).join('/');
-        parts.push(`${rel}:${stat.size}:${Math.floor(stat.mtimeMs)}`);
-    }
-}
-function isRegularDirectory(path) {
-    const stat = lstatSync(path);
-    return stat.isDirectory() && !stat.isSymbolicLink();
-}
-//# sourceMappingURL=sync-author-resources.js.map

package/dist/materialization/sync-author-resources.js.map

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