@antelopejs/dms-ai 0.0.5 → 0.1.0

package/sidecar/dist/providers/codex/protocol/v2.d.ts

@@ -0,0 +1,481 @@
+import type { AbsolutePathBuf, FunctionCallOutputBody, ImageDetail, ImageGenerationItem, LegacyAppPathString, MessagePhase, ReasoningEffort, SleepItem, SubAgentSource, WebSearchItem } from "./common.js";
+import type { JsonValue } from "./serde_json.js";
+export type AgentMessageDelivery = "async";
+export type ApprovalsReviewer = "user" | "auto_review" | "guardian_subagent";
+export type AskForApproval = "untrusted" | "on-request" | {
+    "granular": {
+        sandbox_approval: boolean;
+        rules: boolean;
+        skill_approval: boolean;
+        request_permissions: boolean;
+        mcp_elicitations: boolean;
+    };
+} | "never";
+export type AsyncUserInputQuestion = {
+    title: string;
+    options: Array<string> | null;
+};
+export type ByteRange = {
+    start: number;
+    end: number;
+};
+export type CodexErrorInfo = "contextWindowExceeded" | "sessionBudgetExceeded" | "usageLimitExceeded" | "rateLimitExceeded" | "serverOverloaded" | "cyberPolicy" | "misalignmentPolicyViolation" | {
+    "httpConnectionFailed": {
+        httpStatusCode: number | null;
+    };
+} | {
+    "responseStreamConnectionFailed": {
+        httpStatusCode: number | null;
+    };
+} | "internalServerError" | "unauthorized" | "badRequest" | "threadRollbackFailed" | "sandboxError" | {
+    "responseStreamDisconnected": {
+        httpStatusCode: number | null;
+    };
+} | {
+    "responseTooManyFailedAttempts": {
+        httpStatusCode: number | null;
+    };
+} | {
+    "activeTurnNotSteerable": {
+        turnKind: NonSteerableTurnKind;
+    };
+} | "other";
+export type CollabAgentState = {
+    status: CollabAgentStatus;
+    message: string | null;
+};
+export type CollabAgentStatus = "pendingInit" | "running" | "interrupted" | "completed" | "errored" | "shutdown" | "notFound";
+export type CollabAgentTool = "spawnAgent" | "sendInput" | "resumeAgent" | "wait" | "closeAgent" | "sendMessage" | "followupTask" | "interruptAgent" | "listAgents";
+export type CollabAgentToolCallStatus = "inProgress" | "completed" | "failed" | "interrupted";
+export type CommandAction = {
+    "type": "read";
+    command: string;
+    name: string;
+    path: LegacyAppPathString;
+} | {
+    "type": "listFiles";
+    command: string;
+    path: string | null;
+} | {
+    "type": "search";
+    command: string;
+    query: string | null;
+    path: string | null;
+} | {
+    "type": "unknown";
+    command: string;
+};
+export type CommandExecutionSource = "agent" | "userShell" | "unifiedExecStartup" | "unifiedExecInteraction";
+export type CommandExecutionStatus = "inProgress" | "completed" | "failed" | "declined";
+export type DynamicToolCallOutputContentItem = {
+    "type": "inputText";
+    text: string;
+} | {
+    "type": "inputImage";
+    imageUrl: string;
+} | {
+    "type": "inputAudio";
+    audioUrl: string;
+};
+export type DynamicToolCallStatus = "inProgress" | "completed" | "failed";
+export type FileUpdateChange = {
+    path: string;
+    kind: PatchChangeKind;
+    diff: string;
+};
+export type GitInfo = {
+    sha: string | null;
+    branch: string | null;
+    originUrl: string | null;
+};
+export type HookPromptFragment = {
+    text: string;
+    hookRunId: string;
+};
+export type McpToolCallAppContext = {
+    connectorId: string;
+    linkId: string | null;
+    resourceUri: string | null;
+    appName: string | null;
+    actionName: string | null;
+};
+export type McpToolCallError = {
+    message: string;
+};
+export type McpToolCallResult = {
+    content: Array<JsonValue>;
+    structuredContent: JsonValue | null;
+    _meta: JsonValue | null;
+};
+export type McpToolCallStatus = "inProgress" | "completed" | "failed";
+export type MemoryCitation = {
+    entries: Array<MemoryCitationEntry>;
+    threadIds: Array<string>;
+};
+export type MemoryCitationEntry = {
+    path: string;
+    lineStart: number;
+    lineEnd: number;
+    note: string;
+};
+export type MisalignmentErrorDetails = {
+    errorType: string | null;
+    detailedExplanation: string | null;
+    steer: MisalignmentSteer | null;
+};
+export type MisalignmentSteer = {
+    message: string;
+};
+export type NetworkAccess = "restricted" | "enabled";
+export type NonSteerableTurnKind = "review" | "compact";
+export type PatchApplyStatus = "inProgress" | "completed" | "failed" | "declined";
+export type PatchChangeKind = {
+    "type": "add";
+} | {
+    "type": "delete";
+} | {
+    "type": "update";
+    move_path: string | null;
+};
+export type SandboxMode = "read-only" | "workspace-write" | "danger-full-access";
+export type SandboxPolicy = {
+    "type": "dangerFullAccess";
+} | {
+    "type": "readOnly";
+    networkAccess: boolean;
+} | {
+    "type": "externalSandbox";
+    networkAccess: NetworkAccess;
+} | {
+    "type": "workspaceWrite";
+    writableRoots: Array<AbsolutePathBuf>;
+    networkAccess: boolean;
+    excludeTmpdirEnvVar: boolean;
+    excludeSlashTmp: boolean;
+};
+export type SessionSource = "cli" | "vscode" | "exec" | "appServer" | {
+    "custom": string;
+} | {
+    "subAgent": SubAgentSource;
+} | "unknown";
+export type SkillDependencies = {
+    tools: Array<SkillToolDependency>;
+};
+export type SkillErrorInfo = {
+    path: string;
+    message: string;
+};
+export type SkillInterface = {
+    displayName?: string;
+    shortDescription?: string;
+    iconSmall?: AbsolutePathBuf;
+    iconLarge?: AbsolutePathBuf;
+    iconSmallUrl: string | null;
+    iconLargeUrl: string | null;
+    brandColor?: string;
+    defaultPrompt?: string;
+};
+export type SkillMetadata = {
+    name: string;
+    description: string;
+    shortDescription?: string;
+    interface?: SkillInterface;
+    dependencies?: SkillDependencies;
+    path: AbsolutePathBuf;
+    scope: SkillScope;
+    enabled: boolean;
+    pluginId: string | null;
+};
+export type SkillScope = "user" | "repo" | "system" | "admin";
+export type SkillToolDependency = {
+    type: string;
+    value: string;
+    description?: string;
+    transport?: string;
+    command?: string;
+    url?: string;
+};
+export type SkillsConfigWriteParams = {
+    path?: AbsolutePathBuf | null;
+    name?: string | null;
+    enabled: boolean;
+};
+export type SkillsListEntry = {
+    cwd: string;
+    skills: Array<SkillMetadata>;
+    errors: Array<SkillErrorInfo>;
+};
+export type SkillsListResponse = {
+    data: Array<SkillsListEntry>;
+};
+export type SubAgentActivityKind = "started" | "interacted" | "interrupted" | "completed";
+export type TextElement = {
+    byteRange: ByteRange;
+    placeholder: string | null;
+};
+export type Thread = {
+    id: string;
+    sessionId: string;
+    forkedFromId: string | null;
+    parentThreadId: string | null;
+    preview: string;
+    ephemeral: boolean;
+    section: ThreadSection | null;
+    sectionEnteredAt: number | null;
+    projectId: string | null;
+    historyMode: ThreadHistoryMode;
+    modelProvider: string;
+    model: string | null;
+    reasoningEffort: ReasoningEffort | null;
+    createdAt: number;
+    updatedAt: number;
+    recencyAt: number | null;
+    status: ThreadStatus;
+    path: string | null;
+    cwd: AbsolutePathBuf;
+    cliVersion: string;
+    originator: string | null;
+    source: SessionSource;
+    threadSource: ThreadSource | null;
+    agentNickname: string | null;
+    agentRole: string | null;
+    gitInfo: GitInfo | null;
+    name: string | null;
+    turns: Array<Turn>;
+};
+export type ThreadActiveFlag = "waitingOnApproval" | "waitingOnUserInput";
+export type ThreadHistoryMode = "legacy" | "paginated";
+export type ThreadItem = {
+    "type": "userMessage";
+    id: string;
+    clientId: string | null;
+    content: Array<UserInput>;
+} | {
+    "type": "hookPrompt";
+    id: string;
+    fragments: Array<HookPromptFragment>;
+} | {
+    "type": "agentMessage";
+    id: string;
+    text: string;
+    phase: MessagePhase | null;
+    memoryCitation: MemoryCitation | null;
+    delivery: AgentMessageDelivery | null;
+    questions: Array<AsyncUserInputQuestion> | null;
+} | {
+    "type": "functionCallOutput";
+    id: string;
+    name: string;
+    namespace: string | null;
+    output: FunctionCallOutputBody;
+} | {
+    "type": "plan";
+    id: string;
+    text: string;
+} | {
+    "type": "reasoning";
+    id: string;
+    summary: Array<string>;
+    content: Array<string>;
+} | {
+    "type": "commandExecution";
+    id: string;
+    pluginId: string | null;
+    scriptPath: string | null;
+    command: string;
+    cwd: LegacyAppPathString;
+    processId: string | null;
+    source: CommandExecutionSource;
+    status: CommandExecutionStatus;
+    commandActions: Array<CommandAction>;
+    aggregatedOutput: string | null;
+    exitCode: number | null;
+    durationMs: number | null;
+} | {
+    "type": "fileChange";
+    id: string;
+    changes: Array<FileUpdateChange>;
+    status: PatchApplyStatus;
+} | {
+    "type": "mcpToolCall";
+    id: string;
+    server: string;
+    tool: string;
+    status: McpToolCallStatus;
+    arguments: JsonValue;
+    appContext: McpToolCallAppContext | null;
+    mcpAppResourceUri?: string;
+    pluginId: string | null;
+    readOnlyHint: boolean | null;
+    result: McpToolCallResult | null;
+    error: McpToolCallError | null;
+    durationMs: number | null;
+} | {
+    "type": "dynamicToolCall";
+    id: string;
+    namespace: string | null;
+    tool: string;
+    arguments: JsonValue;
+    status: DynamicToolCallStatus;
+    contentItems: Array<DynamicToolCallOutputContentItem> | null;
+    success: boolean | null;
+    durationMs: number | null;
+} | {
+    "type": "collabAgentToolCall";
+    id: string;
+    tool: CollabAgentTool;
+    status: CollabAgentToolCallStatus;
+    senderThreadId: string;
+    receiverThreadIds: Array<string>;
+    prompt: string | null;
+    model: string | null;
+    reasoningEffort: ReasoningEffort | null;
+    agentsStates: {
+        [key in string]?: CollabAgentState;
+    };
+} | {
+    "type": "subAgentActivity";
+    id: string;
+    kind: SubAgentActivityKind;
+    agentThreadId: string;
+    agentPath: string;
+} | {
+    "type": "webSearch";
+} & WebSearchItem | {
+    "type": "imageView";
+    id: string;
+    path: LegacyAppPathString;
+} | {
+    "type": "sleep";
+} & SleepItem | {
+    "type": "imageGeneration";
+} & ImageGenerationItem | {
+    "type": "enteredReviewMode";
+    id: string;
+    review: string;
+} | {
+    "type": "exitedReviewMode";
+    id: string;
+    review: string;
+} | {
+    "type": "contextCompaction";
+    id: string;
+};
+export type ThreadSection = {
+    id: string;
+    name: string;
+    appearance: ThreadSectionAppearance | null;
+};
+export type ThreadSectionAppearance = {
+    icon: string | null;
+    color: string | null;
+};
+export type ThreadSource = string;
+export type ThreadStartResponse = {
+    thread: Thread;
+    model: string;
+    modelProvider: string;
+    serviceTier: string | null;
+    cwd: AbsolutePathBuf;
+    instructionSources: Array<LegacyAppPathString>;
+    approvalPolicy: AskForApproval;
+    approvalsReviewer: ApprovalsReviewer;
+    sandbox: SandboxPolicy;
+    reasoningEffort: ReasoningEffort | null;
+};
+export type ThreadStatus = {
+    "type": "notLoaded";
+} | {
+    "type": "idle";
+} | {
+    "type": "systemError";
+} | {
+    "type": "active";
+    activeFlags: Array<ThreadActiveFlag>;
+};
+export type ThreadTokenUsage = {
+    total: TokenUsageBreakdown;
+    last: TokenUsageBreakdown;
+    modelContextWindow: number | null;
+};
+export type ThreadTokenUsageUpdatedNotification = {
+    threadId: string;
+    turnId: string;
+    tokenUsage: ThreadTokenUsage;
+};
+export type TokenUsageBreakdown = {
+    totalTokens: number;
+    inputTokens: number;
+    cachedInputTokens: number;
+    cacheWriteInputTokens: number;
+    outputTokens: number;
+    reasoningOutputTokens: number;
+};
+export type Turn = {
+    id: string;
+    items: Array<ThreadItem>;
+    itemsView: TurnItemsView;
+    status: TurnStatus;
+    error: TurnError | null;
+    startedAt: number | null;
+    completedAt: number | null;
+    durationMs: number | null;
+};
+export type TurnError = {
+    message: string;
+    codexErrorInfo: CodexErrorInfo | null;
+    additionalDetails: string | null;
+    misalignment: MisalignmentErrorDetails | null;
+};
+export type TurnItemsView = "notLoaded" | "summary" | "full";
+export type TurnPlanStep = {
+    step: string;
+    status: TurnPlanStepStatus;
+};
+export type TurnPlanStepStatus = "pending" | "inProgress" | "completed";
+export type TurnStartedNotification = {
+    threadId: string;
+    turn: Turn;
+};
+export type TurnStatus = "completed" | "interrupted" | "failed" | "inProgress";
+export type UserInput = {
+    "type": "text";
+    text: string;
+    text_elements: Array<TextElement>;
+} | {
+    "type": "image";
+    detail?: ImageDetail;
+    url: string;
+} | {
+    "type": "localImage";
+    detail?: ImageDetail;
+    path: string;
+} | {
+    "type": "audio";
+    url: string;
+} | {
+    "type": "localAudio";
+    path: string;
+} | {
+    "type": "skill";
+    name: string;
+    path: string;
+} | {
+    "type": "mention";
+    name: string;
+    path: string;
+};
+export type WebSearchAction = {
+    "type": "search";
+    query: string | null;
+    queries: Array<string> | null;
+} | {
+    "type": "openPage";
+    url: string | null;
+} | {
+    "type": "findInPage";
+    url: string | null;
+    pattern: string | null;
+} | {
+    "type": "other";
+};

package/sidecar/dist/providers/codex/protocol/v2.js

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

package/sidecar/dist/providers/codex/protocol/v2.js.map

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

package/sidecar/dist/providers/codex/provider.d.ts

@@ -0,0 +1,14 @@
+import type { AgentProvider, AgentProviderOptions } from "../../agent/provider.js";
+import type { McpHttpRegistry } from "../../mcp/http-binding.js";
+import type { AiMcpServerDeps } from "../../mcp/types.js";
+interface CodexRuntimeDeps {
+    stateDir: string;
+    mcpHttpRegistry: McpHttpRegistry;
+    getMcpUrl: () => string;
+    getApiKey: () => string | undefined;
+}
+export interface CodexProviderOptions extends AgentProviderOptions, CodexRuntimeDeps {
+    createMcpDeps: (conversationId: string) => AiMcpServerDeps;
+}
+export declare function createCodexProvider(options: CodexProviderOptions): AgentProvider;
+export {};