@mastra/code-sdk 1.15.0-alpha.1 → 1.15.0-alpha.10

package/dist/factory/remote-controller.d.ts

@@ -0,0 +1,34 @@
+import type { AvailableModel, ModelAuthStatus } from '@mastra/core/agent-controller';
+import type { FactoryAddress } from './client.js';
+import { createFactoryClient } from './client.js';
+export interface RemoteMode {
+    id: string;
+    name?: string;
+    description?: string;
+    default?: boolean;
+    defaultModelId?: string;
+    metadata?: Record<string, unknown>;
+}
+type ControllerHandle = ReturnType<ReturnType<typeof createFactoryClient>['getAgentController']>;
+/**
+ * The Factory-side counterpart to the local agent controller. Modes, models, and
+ * provider auth come from the Factory, never from local settings or auth storage.
+ */
+export declare class RemoteController {
+    #private;
+    readonly id = "code";
+    constructor(address: FactoryAddress, remote?: ControllerHandle);
+    /** Load the mode list; `listModes()` is synchronous so it must be primed. */
+    connect(): Promise<void>;
+    listModes(): RemoteMode[];
+    listAvailableModels(): Promise<AvailableModel[]>;
+    invalidateAvailableModelsCache(): void;
+    /** Auth is the Factory's: report what it reports, or assume ok and let the run surface errors. */
+    getCurrentModelAuthStatus(session: {
+        model: {
+            get(): string;
+        };
+    }): Promise<ModelAuthStatus>;
+}
+export {};
+//# sourceMappingURL=remote-controller.d.ts.map

package/dist/factory/remote-controller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"remote-controller.d.ts","sourceRoot":"","sources":["../../src/factory/remote-controller.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAErF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAE,mBAAmB,EAAyB,MAAM,aAAa,CAAC;AAEzE,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED,KAAK,gBAAgB,GAAG,UAAU,CAAC,UAAU,CAAC,OAAO,mBAAmB,CAAC,CAAC,oBAAoB,CAAC,CAAC,CAAC;AAEjG;;;GAGG;AACH,qBAAa,gBAAgB;;IAC3B,QAAQ,CAAC,EAAE,UAAyB;gBAKxB,OAAO,EAAE,cAAc,EAAE,MAAM,CAAC,EAAE,gBAAgB;IAI9D,6EAA6E;IACvE,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAI9B,SAAS,IAAI,UAAU,EAAE;IAIzB,mBAAmB,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC;IAMhD,8BAA8B,IAAI,IAAI;IAItC,kGAAkG;IAC5F,yBAAyB,CAAC,OAAO,EAAE;QAAE,KAAK,EAAE;YAAE,GAAG,IAAI,MAAM,CAAA;SAAE,CAAA;KAAE,GAAG,OAAO,CAAC,eAAe,CAAC;CAMjG"}

package/dist/factory/remote-controller.js

@@ -0,0 +1,43 @@
+import { FACTORY_CONTROLLER_ID, createFactoryClient } from "./client.js";
+//#region src/factory/remote-controller.ts
+/**
+* The Factory-side counterpart to the local agent controller. Modes, models, and
+* provider auth come from the Factory, never from local settings or auth storage.
+*/
+var RemoteController = class {
+	id = FACTORY_CONTROLLER_ID;
+	#remote;
+	#modes = [];
+	#models;
+	constructor(address, remote) {
+		this.#remote = remote ?? createFactoryClient(address).getAgentController("code");
+	}
+	/** Load the mode list; `listModes()` is synchronous so it must be primed. */
+	async connect() {
+		this.#modes = await this.#remote.listModes();
+	}
+	listModes() {
+		return this.#modes;
+	}
+	listAvailableModels() {
+		this.#models ??= this.#remote.listModels().then((models) => models);
+		this.#models.catch(() => this.#models = void 0);
+		return this.#models;
+	}
+	invalidateAvailableModelsCache() {
+		this.#models = void 0;
+	}
+	/** Auth is the Factory's: report what it reports, or assume ok and let the run surface errors. */
+	async getCurrentModelAuthStatus(session) {
+		const modelId = session.model.get();
+		const model = (await this.listAvailableModels().catch(() => [])).find((m) => m.id === modelId);
+		return model ? {
+			hasAuth: model.hasApiKey,
+			apiKeyEnvVar: model.apiKeyEnvVar
+		} : { hasAuth: true };
+	}
+};
+//#endregion
+export { RemoteController };
+
+//# sourceMappingURL=remote-controller.js.map

package/dist/factory/remote-controller.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"remote-controller.js","names":["#remote","#modes","#models"],"sources":["../../src/factory/remote-controller.ts"],"sourcesContent":["import type { AvailableModel, ModelAuthStatus } from '@mastra/core/agent-controller';\n\nimport type { FactoryAddress } from './client.js';\nimport { createFactoryClient, FACTORY_CONTROLLER_ID } from './client.js';\n\nexport interface RemoteMode {\n  id: string;\n  name?: string;\n  description?: string;\n  default?: boolean;\n  defaultModelId?: string;\n  metadata?: Record<string, unknown>;\n}\n\ntype ControllerHandle = ReturnType<ReturnType<typeof createFactoryClient>['getAgentController']>;\n\n/**\n * The Factory-side counterpart to the local agent controller. Modes, models, and\n * provider auth come from the Factory, never from local settings or auth storage.\n */\nexport class RemoteController {\n  readonly id = FACTORY_CONTROLLER_ID;\n  readonly #remote: ControllerHandle;\n  #modes: RemoteMode[] = [];\n  #models: Promise<AvailableModel[]> | undefined;\n\n  constructor(address: FactoryAddress, remote?: ControllerHandle) {\n    this.#remote = remote ?? createFactoryClient(address).getAgentController(FACTORY_CONTROLLER_ID);\n  }\n\n  /** Load the mode list; `listModes()` is synchronous so it must be primed. */\n  async connect(): Promise<void> {\n    this.#modes = (await this.#remote.listModes()) as RemoteMode[];\n  }\n\n  listModes(): RemoteMode[] {\n    return this.#modes;\n  }\n\n  listAvailableModels(): Promise<AvailableModel[]> {\n    this.#models ??= this.#remote.listModels().then(models => models as AvailableModel[]);\n    this.#models.catch(() => (this.#models = undefined));\n    return this.#models;\n  }\n\n  invalidateAvailableModelsCache(): void {\n    this.#models = undefined;\n  }\n\n  /** Auth is the Factory's: report what it reports, or assume ok and let the run surface errors. */\n  async getCurrentModelAuthStatus(session: { model: { get(): string } }): Promise<ModelAuthStatus> {\n    const modelId = session.model.get();\n    const models = await this.listAvailableModels().catch(() => []);\n    const model = models.find(m => m.id === modelId);\n    return model ? { hasAuth: model.hasApiKey, apiKeyEnvVar: model.apiKeyEnvVar } : { hasAuth: true };\n  }\n}\n"],"mappings":";;;;;;AAoBA,IAAa,mBAAb,MAA8B;CAC5B,KAAc;CACd;CACA,SAAuB,CAAC;CACxB;CAEA,YAAY,SAAyB,QAA2B;EAC9D,KAAKA,UAAU,UAAU,oBAAoB,OAAO,CAAC,CAAC,mBAAA,MAAwC;CAChG;;CAGA,MAAM,UAAyB;EAC7B,KAAKC,SAAU,MAAM,KAAKD,QAAQ,UAAU;CAC9C;CAEA,YAA0B;EACxB,OAAO,KAAKC;CACd;CAEA,sBAAiD;EAC/C,KAAKC,YAAY,KAAKF,QAAQ,WAAW,CAAC,CAAC,MAAK,WAAU,MAA0B;EACpF,KAAKE,QAAQ,YAAa,KAAKA,UAAU,KAAA,CAAU;EACnD,OAAO,KAAKA;CACd;CAEA,iCAAuC;EACrC,KAAKA,UAAU,KAAA;CACjB;;CAGA,MAAM,0BAA0B,SAAiE;EAC/F,MAAM,UAAU,QAAQ,MAAM,IAAI;EAElC,MAAM,SAAQ,MADO,KAAK,oBAAoB,CAAC,CAAC,YAAY,CAAC,CAAC,EAAA,CACzC,MAAK,MAAK,EAAE,OAAO,OAAO;EAC/C,OAAO,QAAQ;GAAE,SAAS,MAAM;GAAW,cAAc,MAAM;EAAa,IAAI,EAAE,SAAS,KAAK;CAClG;AACF"}

package/dist/factory/remote-session.d.ts

@@ -0,0 +1,210 @@
+import type { AgentControllerModeInfo } from '@mastra/client-js';
+import type { AgentControllerDisplayState, AgentControllerEventListener, AgentControllerRequestStateUpdater, AgentControllerThread, PermissionRules, Session } from '@mastra/core/agent-controller';
+import type { FactoryAddress } from './client.js';
+import { createFactoryClient } from './client.js';
+type RemoteHandle = ReturnType<ReturnType<ReturnType<typeof createFactoryClient>['getAgentController']>['session']>;
+type RemoteMode = AgentControllerModeInfo;
+type Files = Array<{
+    data: string;
+    mediaType: string;
+    filename?: string;
+}>;
+/**
+ * Stands in for an in-process `Session` while the agent, tools, and storage
+ * run inside a Factory. Reads are served from state mirrored off the session's
+ * event stream; every action is forwarded to the Factory over HTTP.
+ *
+ * Only the surface the TUI drives is implemented. Anything else resolves to a
+ * no-op so local-only features (thread locks, grants) degrade instead of crash.
+ */
+export declare class RemoteSession {
+    #private;
+    constructor(address: FactoryAddress, sessionId: string, remote?: RemoteHandle);
+    /** Create/resume the remote session, hydrate the mirror, and open the event stream. */
+    connect(): Promise<void>;
+    /** Modes come from the controller; used to resolve the current mode's name and color. */
+    setModes(modes: RemoteMode[]): void;
+    disconnect(): void;
+    subscribe(listener: AgentControllerEventListener): () => void;
+    onBeforeAgentEnd(): () => void;
+    readonly identity: {
+        getResourceId: () => string;
+        getDefaultResourceId: () => string;
+        getId: () => string;
+        getOwnerId: () => string;
+        setResourceId: () => void;
+    };
+    readonly thread: {
+        getId: () => string | null;
+        isSet: () => boolean;
+        requireId: () => string;
+        ensureId: () => Promise<string>;
+        list: () => Promise<AgentControllerThread[]>;
+        getById: ({ threadId }: {
+            threadId: string;
+        }) => Promise<AgentControllerThread | null>;
+        create: ({ title }?: {
+            title?: string;
+        }) => Promise<AgentControllerThread>;
+        switch: ({ threadId }: {
+            threadId: string;
+        }) => Promise<void>;
+        clone: ({ sourceThreadId, title }?: {
+            sourceThreadId?: string;
+            title?: string;
+        }) => Promise<AgentControllerThread>;
+        rename: ({ title }: {
+            title: string;
+        }) => Promise<void>;
+        delete: ({ threadId }: {
+            threadId: string;
+        }) => Promise<void>;
+        listMessages: ({ threadId, limit }: {
+            threadId: string;
+            limit?: number;
+        }) => Promise<import("@mastra/client-js").MastraDBMessage[]>;
+        listActiveMessages: ({ limit }?: {
+            limit?: number;
+        }) => Promise<never[] | import("@mastra/client-js").MastraDBMessage[]>;
+        firstUserMessage: () => Promise<null>;
+        firstUserMessages: () => Promise<Map<any, any>>;
+        getSetting: () => Promise<undefined>;
+        getSettingOn: () => Promise<undefined>;
+        setSetting: () => Promise<void>;
+        setSettingOn: () => Promise<void>;
+        deleteSetting: () => Promise<void>;
+        cleanupSubscription: () => void;
+        detachFromCurrent: () => void;
+        clear: () => void;
+        clearAndReleaseLock: () => Promise<void>;
+        cloneToCurrentResource: ({ sourceThreadId }: {
+            sourceThreadId: string;
+        }) => Promise<AgentControllerThread>;
+        loadMetadata: () => Promise<void>;
+    };
+    readonly mode: {
+        get: () => string;
+        hasSelection: () => boolean;
+        resolve: () => {
+            id: string;
+            name?: string | undefined | undefined;
+        };
+        set: ({ modeId }: {
+            modeId: string;
+        }) => void;
+        switch: ({ modeId }: {
+            modeId: string;
+        }) => Promise<void>;
+    };
+    readonly model: {
+        get: () => string;
+        hasSelection: () => boolean;
+        displayName: () => string;
+        set: ({ modelId }: {
+            modelId: string;
+        }) => void;
+        switch: (modelId: string, options?: {
+            thinkingLevel?: any;
+        }) => Promise<void>;
+        syncFromPersisted: () => Promise<void>;
+    };
+    readonly state: {
+        get: () => Record<string, unknown>;
+        set: (updates: Record<string, unknown>) => Promise<void>;
+        setIf: (updates: Record<string, unknown>, shouldApply: () => boolean) => Promise<boolean>;
+        update: <TResult>(updater: AgentControllerRequestStateUpdater<any, TResult>) => Promise<TResult>;
+    };
+    readonly displayState: {
+        get: () => AgentControllerDisplayState;
+        clearModifiedFiles: () => void;
+        restoreTasks: () => void;
+        clearPendingSuspensions: () => void;
+        deletePendingSuspension: () => void;
+        clearPendingApprovals: () => void;
+        resetThread: () => void;
+        apply: () => void;
+    };
+    readonly run: {
+        isRunning: () => boolean;
+        getRunId: () => null;
+        getTraceId: () => null;
+    };
+    readonly stream: {
+        isActive: () => boolean;
+        isOpen: () => boolean;
+    };
+    readonly suspensions: {
+        hasPending: () => boolean;
+        get: ({ toolCallId }: {
+            toolCallId: string;
+        }) => {
+            toolCallId: string;
+            toolName: string;
+            args: unknown;
+            suspendPayload: unknown;
+            resumeSchema?: string;
+            resourceId?: string;
+            threadId?: string;
+            runId?: string;
+        } | undefined;
+        has: ({ toolCallId }: {
+            toolCallId: string;
+        }) => boolean;
+        delete: () => void;
+    };
+    readonly permissions: {
+        getRules: () => PermissionRules;
+        setForCategory: ({ category, policy }: {
+            category: any;
+            policy: any;
+        }) => Promise<void>;
+        setForTool: ({ toolName, policy }: {
+            toolName: string;
+            policy: any;
+        }) => Promise<void>;
+    };
+    getCurrentRunId(): string | null;
+    getTags(): Record<string, string>;
+    getTokenUsage(): import("@mastra/core/harness").TokenUsage;
+    getGrants(): {
+        categories: never[];
+        tools: never[];
+    };
+    sendMessage({ content, files }: {
+        content: string;
+        files?: Files;
+    }): Promise<void>;
+    queueMessage({ content }: {
+        content: string;
+    }): Promise<void>;
+    sendSignal(input: Parameters<Session['sendSignal']>[0]): {
+        id: `${string}-${string}-${string}-${string}-${string}`;
+        type: "user";
+        accepted: Promise<{
+            accepted: true;
+        }>;
+        persisted: Promise<void>;
+    };
+    steer({ content }: {
+        content: string;
+    }): Promise<void>;
+    followUp({ content }: {
+        content: string;
+    }): Promise<void>;
+    respondToToolApproval({ decision, toolCallId, }: {
+        decision: 'approve' | 'decline' | 'always_allow_category';
+        toolCallId: string;
+    }): {
+        accepted: true;
+    };
+    respondToToolSuspension({ resumeData, toolCallId }: {
+        resumeData: unknown;
+        toolCallId?: string;
+    }): Promise<void>;
+    claimToolResponse(): boolean;
+    releaseToolResponse(): void;
+    abort(): void;
+    abortRun(): void;
+}
+export {};
+//# sourceMappingURL=remote-session.d.ts.map

package/dist/factory/remote-session.d.ts.map

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