@ellipsis-dev/sdk 0.43.0 → 0.44.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/index.d.ts +48 -45
- package/dist/index.js +23 -0
- package/dist/store/index.d.ts +1 -1
- package/dist/stream/index.d.ts +1 -1
- package/dist/{types-BAJ82SH6.d.ts → types-Dwyd1Aud.d.ts} +224 -106
- package/package.json +1 -1
- package/schema/collection_frames.schema.json +19 -57
- package/schema/frames.schema.json +19 -57
- package/schema/lifecycle.schema.json +2 -1
- package/schema/openapi.v1.json +351 -103
package/dist/index.d.ts
CHANGED
|
@@ -1,5 +1,5 @@
|
|
|
1
|
-
import { c as components } from './types-
|
|
2
|
-
export { A as AgentConfig, a as AgentIdentity, b as AttributionType, B as BudgetConfig, C as CheckRunAction, d as CheckSuiteAction, e as ClaudeAssistantEvent, f as ClaudeAssistantMessage, g as ClaudeConfig, h as ClaudeConversationResetEvent, i as ClaudeNativeEvent, j as ClaudeNativeSessionRecord, k as ClaudeNativeUsage, l as ClaudeRateLimitEvent, m as ClaudeRateLimitInfo, n as ClaudeResultEvent, o as ClaudeSessionRecord, p as ClaudeSystemEvent, q as ClaudeUserEvent, r as ClaudeUserMessage, s as CodexAgentMessage, t as CodexAgentMessageItem, u as CodexAppServerError, v as CodexAppServerEvent, w as CodexAppServerItem, x as CodexAppServerNotification, y as CodexAppServerSessionRecord, z as CodexCollabAgentToolCall, D as CodexCommandExecution, E as CodexCommandExecutionItem, F as CodexConfig, G as CodexContextCompaction, H as CodexEffortLevel, I as CodexErrorEvent, J as CodexErrorItem, K as CodexErrorParams, L as CodexEvent, M as CodexFileChange, N as CodexFileChangeItem, O as CodexFileUpdate, P as CodexItem, Q as CodexItemCompleted, R as CodexItemCompletedEvent, S as CodexItemParams, T as CodexItemStarted, U as CodexItemStartedEvent, V as CodexItemUpdatedEvent, W as CodexLocalImageInput, X as CodexMcpToolCall, Y as CodexMcpToolCallAppContext, Z as CodexMcpToolCallError, _ as CodexMcpToolCallItem, $ as CodexMcpToolCallResult, a0 as CodexPlan, a1 as CodexReasoning, a2 as CodexReasoningItem, a3 as CodexSessionRecord, a4 as CodexSubAgentActivity, a5 as CodexTextInput, a6 as CodexThread, a7 as CodexThreadStarted, a8 as CodexThreadStartedEvent, a9 as CodexThreadStartedParams, aa as CodexThreadTokenUsage, ab as CodexTodoListItem, ac as CodexTokenUsageBreakdown, ad as CodexTokenUsageParams, ae as CodexTokenUsageUpdated, af as CodexTurn, ag as CodexTurnCompleted, ah as CodexTurnCompletedEvent, ai as CodexTurnError, aj as CodexTurnFailedEvent, ak as CodexTurnParams, al as CodexTurnStarted, am as CodexTurnStartedEvent, an as CodexUsage, ao as CodexUserInput, ap as CodexUserMessage, aq as CodexWebSearch, ar as CodexWebSearchItem, as as ComputeConfig, at as ComputeConfig1, au as ConfigMetadata, av as Cost, aw as Cost1, ax as CronTrigger, ay as DeltaFrame, az as
|
|
1
|
+
import { c as components } from './types-Dwyd1Aud.js';
|
|
2
|
+
export { A as AgentConfig, a as AgentIdentity, b as AttributionType, B as BudgetConfig, C as CheckRunAction, d as CheckSuiteAction, e as ClaudeAssistantEvent, f as ClaudeAssistantMessage, g as ClaudeConfig, h as ClaudeConversationResetEvent, i as ClaudeNativeEvent, j as ClaudeNativeSessionRecord, k as ClaudeNativeUsage, l as ClaudeRateLimitEvent, m as ClaudeRateLimitInfo, n as ClaudeResultEvent, o as ClaudeSessionRecord, p as ClaudeSystemEvent, q as ClaudeUserEvent, r as ClaudeUserMessage, s as CodexAgentMessage, t as CodexAgentMessageItem, u as CodexAppServerError, v as CodexAppServerEvent, w as CodexAppServerItem, x as CodexAppServerNotification, y as CodexAppServerSessionRecord, z as CodexCollabAgentToolCall, D as CodexCommandExecution, E as CodexCommandExecutionItem, F as CodexConfig, G as CodexContextCompaction, H as CodexEffortLevel, I as CodexErrorEvent, J as CodexErrorItem, K as CodexErrorParams, L as CodexEvent, M as CodexFileChange, N as CodexFileChangeItem, O as CodexFileUpdate, P as CodexItem, Q as CodexItemCompleted, R as CodexItemCompletedEvent, S as CodexItemParams, T as CodexItemStarted, U as CodexItemStartedEvent, V as CodexItemUpdatedEvent, W as CodexLocalImageInput, X as CodexMcpToolCall, Y as CodexMcpToolCallAppContext, Z as CodexMcpToolCallError, _ as CodexMcpToolCallItem, $ as CodexMcpToolCallResult, a0 as CodexPlan, a1 as CodexReasoning, a2 as CodexReasoningItem, a3 as CodexSessionRecord, a4 as CodexSubAgentActivity, a5 as CodexTextInput, a6 as CodexThread, a7 as CodexThreadStarted, a8 as CodexThreadStartedEvent, a9 as CodexThreadStartedParams, aa as CodexThreadTokenUsage, ab as CodexTodoListItem, ac as CodexTokenUsageBreakdown, ad as CodexTokenUsageParams, ae as CodexTokenUsageUpdated, af as CodexTurn, ag as CodexTurnCompleted, ah as CodexTurnCompletedEvent, ai as CodexTurnError, aj as CodexTurnFailedEvent, ak as CodexTurnParams, al as CodexTurnStarted, am as CodexTurnStartedEvent, an as CodexUsage, ao as CodexUserInput, ap as CodexUserMessage, aq as CodexWebSearch, ar as CodexWebSearchItem, as as ComputeConfig, at as ComputeConfig1, au as ConfigMetadata, av as Cost, aw as Cost1, ax as CronTrigger, ay as DeltaFrame, az as EffortLevel, aA as EllipsisGrant, aB as EllipsisPermissions, aC as EnvironmentBaseBuild, aD as EnvironmentConfig, aE as EnvironmentHooks, aF as EnvironmentHooks1, aG as EnvironmentOutputPayload, aH as EnvironmentOutputRecord, aI as EnvironmentPhasePayload, aJ as EnvironmentPhaseRecord, aK as EnvironmentReadyPayload, aL as EnvironmentReadyRecord, aM as EnvironmentScript, aN as EnvironmentSource, aO as EnvironmentVariable, aP as ErrorFrame, aQ as ErrorReason, aR as GeminiConfig, aS as GeminiErrorEvent, aT as GeminiInitEvent, aU as GeminiMessageEvent, aV as GeminiModelStats, aW as GeminiResultEvent, aX as GeminiSessionRecord, aY as GeminiStreamEvent, aZ as GeminiStreamStats, a_ as GeminiToolError, a$ as GeminiToolResultEvent, b0 as GeminiToolUseEvent, b1 as GithubAccountFilter, b2 as GithubAccountSelector, b3 as GithubAccountSnippet, b4 as GithubAccountType, b5 as GithubCheckRunEvent, b6 as GithubCheckSuiteEvent, b7 as GithubIssueEvent, b8 as GithubPermissions, b9 as GithubPullRequestEvent, ba as GithubPushEvent, bb as GithubReleaseEvent, bc as GithubStatusEvent, bd as GithubWorkflowRunEvent, be as HandlerService, bf as HeartbeatFrame, bg as InputContract, bh as IssueAction, bi as LegacyAssistantPayload, bj as LegacyNativeUsage, bk as LegacyResultPayload, bl as Level, bm as LifecycleSessionRecord, bn as LinearIssueAction, bo as LinearIssueChanged, bp as LinearIssueEvent, bq as LinearLabelsChange, br as LinearValueChange, bs as LinearValueFilter, bt as LlmCost, bu as LlmCostSplit, bv as McpRemoteServer, bw as McpServerRef, bx as McpStdioServer, by as MemorySize, bz as MessageEndedPayload, bA as MessageEndedRecord, bB as MessageQueuedPayload, bC as MessageQueuedRecord, bD as MessageRecord, bE as MessageRequeuedPayload, bF as MessageRequeuedRecord, bG as MessageStartedPayload, bH as MessageStartedRecord, bI as ModelLlmCostSplit, bJ as ModelTokenCounts, bK as OutputConfig, bL as PermissionsConfig, bM as PermissionsConfig1, bN as PlatformSessionRecord, bO as PromptBlockedReason, bP as PullRequest, bQ as PullRequestAction, bR as ReactCheckRun, bS as ReactCheckSuite, bT as ReactIssue, bU as ReactLinearIssue, bV as ReactPullRequest, bW as ReactPush, bX as ReactRelease, bY as ReactSentry, bZ as ReactSlackChannel, b_ as ReactStatus, b$ as ReactTrigger, c0 as ReactWorkflowRun, c1 as RecordsFrame, c2 as ReleaseAction, c3 as RepositoryFilter, c4 as RepositoryRef, c5 as Review, c6 as ReviewComment, c7 as ReviewConfig, c8 as ReviewConfigsListResponse, c9 as ReviewReviewer, ca as ReviewSummary, cb as ReviewsListResponse, cc as SdkAssistantRecord, cd as SdkCacheCreation, ce as SdkContentBlock, cf as SdkRateLimitRecord, cg as SdkRecord, ch as SdkResultRecord, ci as SdkServerToolResultBlock, cj as SdkServerToolUseBlock, ck as SdkSystemRecord, cl as SdkTextBlock, cm as SdkThinkingBlock, cn as SdkToolResultBlock, co as SdkToolUseBlock, cp as SdkUserRecord, cq as SendSessionMessageRequest, cr as SentryAction, cs as SentryAlertEvent, ct as Session, cu as SessionAgent, cv as SessionArchived, cw as SessionAttribution, cx as SessionClosedPayload, cy as SessionClosedRecord, cz as SessionConfig, cA as SessionConversation, cB as SessionConversationConfig, cC as SessionEnvironment, cD as SessionError, cE as SessionEventActor, cF as SessionFrame, cG as SessionGit, cH as SessionGitCommit, cI as SessionGitFile, cJ as SessionGitPr, cK as SessionGitRepo, cL as SessionHandler, cM as SessionMessage, cN as SessionMessageImage, cO as SessionMessageResponse, cP as SessionOutput, cQ as SessionParent, cR as SessionPrompting, cS as SessionRecord, cT as SessionRecordsListResponse, cU as SessionResponse, cV as SessionReview, cW as SessionSource, cX as SessionStatus, cY as SessionStreamFrame, cZ as SessionSummary, c_ as SessionSummarySource, c$ as SessionsListResponse, d0 as SettingsRef, d1 as SkillRef, d2 as SlackChannelCreatedEvent, d3 as SlackMessageEvent, d4 as StatusAction, d5 as StreamFrame, d6 as TokenCounts, d7 as Tokens, d8 as Tokens1, d9 as TokensInfo, da as UnknownSessionRecord, db as UpdateSessionRequest, dc as WorkflowRunAction, dd as paths } from './types-Dwyd1Aud.js';
|
|
3
3
|
|
|
4
4
|
/**
|
|
5
5
|
* Frames on /v1/sessions/stream, /v1/agents/stream and /v1/vm-executions/{id}/stream. Ignore unknown frame types.
|
|
@@ -246,7 +246,7 @@ type EnvironmentSource = 'request' | 'agent' | 'repo_default' | 'account_default
|
|
|
246
246
|
/**
|
|
247
247
|
* What went wrong.
|
|
248
248
|
*/
|
|
249
|
-
type ErrorReason = 'error' | 'tool_call_failed' | 'budget_hit' | 'payment_required' | 'blocked' | 'contact_email_required' | 'lifecycle_hook_failed' | 'missing_repo_access' | 'missing_token_permissions' | 'missing_environment_variables' | 'missing_github_integration' | 'agent_unavailable' | 'upstream_unavailable' | 'unsupported_configuration' | 'execution_disabled' | 'interrupted' | 'stopped';
|
|
249
|
+
type ErrorReason = 'error' | 'tool_call_failed' | 'budget_hit' | 'payment_required' | 'blocked' | 'contact_email_required' | 'lifecycle_hook_failed' | 'missing_repo_access' | 'missing_token_permissions' | 'missing_environment_variables' | 'missing_github_integration' | 'agent_unavailable' | 'upstream_unavailable' | 'unsupported_configuration' | 'execution_disabled' | 'interrupted' | 'stopped' | 'timeout';
|
|
250
250
|
/**
|
|
251
251
|
* The service the handler responds to.
|
|
252
252
|
*/
|
|
@@ -458,29 +458,27 @@ interface EnvironmentConfig {
|
|
|
458
458
|
variables: EnvironmentVariable[];
|
|
459
459
|
}
|
|
460
460
|
/**
|
|
461
|
-
*
|
|
462
|
-
*
|
|
463
|
-
* outside the platform bounds fails validation
|
|
464
|
-
* config) rather than being clamped silently.
|
|
461
|
+
* The size and lifetime of the environment. Every field is optional. An
|
|
462
|
+
* omitted field takes the platform default (2 vCPUs, 4096 MiB, a 4h timeout,
|
|
463
|
+
* 10m idle). A value outside the platform bounds fails validation.
|
|
465
464
|
*
|
|
466
|
-
* `memory`
|
|
467
|
-
*
|
|
468
|
-
* `
|
|
469
|
-
* the environment is sized with.
|
|
465
|
+
* `memory` accepts a string such as `8GB` or an object such as `{gb: 8}`.
|
|
466
|
+
* `timeout` and `idle` accept a duration string such as `30m`, `8h`, or
|
|
467
|
+
* `1h30m`.
|
|
470
468
|
*
|
|
471
|
-
* `timeout` is the
|
|
472
|
-
*
|
|
473
|
-
* shortens a session; the cap matches the 1-hour validity of the session's
|
|
474
|
-
* GitHub token).
|
|
469
|
+
* `timeout` is the longest one message's work may run before it is stopped,
|
|
470
|
+
* 1m to 22h, default 4h. The message ends `stopped` with reason `timeout`.
|
|
475
471
|
*
|
|
476
|
-
*
|
|
477
|
-
*
|
|
478
|
-
*
|
|
472
|
+
* `idle` is how long the environment stays awake after the agent finishes
|
|
473
|
+
* with no message waiting, 10s to 1h, default 10m. Then it pauses, and the
|
|
474
|
+
* next message resumes it. Only an interactive session pauses. A session
|
|
475
|
+
* that runs once ends when its message ends.
|
|
479
476
|
*/
|
|
480
477
|
interface ComputeConfig {
|
|
481
478
|
cpu: number | null;
|
|
479
|
+
idle: string | null;
|
|
482
480
|
memory: string | MemorySize | null;
|
|
483
|
-
timeout: string |
|
|
481
|
+
timeout: string | null;
|
|
484
482
|
}
|
|
485
483
|
/**
|
|
486
484
|
* A memory size as explicit units, summed (binary: 1GB = 1024MB = 1024MiB).
|
|
@@ -491,16 +489,6 @@ interface MemorySize {
|
|
|
491
489
|
gb: number | null;
|
|
492
490
|
mb: number | null;
|
|
493
491
|
}
|
|
494
|
-
/**
|
|
495
|
-
* A duration as explicit units, summed. Set any of `hours`/`minutes`/
|
|
496
|
-
* `seconds` (at least one). The alternative to the `30m`-style shorthand
|
|
497
|
-
* string wherever a duration is accepted.
|
|
498
|
-
*/
|
|
499
|
-
interface Duration {
|
|
500
|
-
hours: number | null;
|
|
501
|
-
minutes: number | null;
|
|
502
|
-
seconds: number | null;
|
|
503
|
-
}
|
|
504
492
|
/**
|
|
505
493
|
* Environment lifecycle scripts, in order: build_base, after_checkout,
|
|
506
494
|
* before_start, validate. The first two produce reusable snapshots;
|
|
@@ -1071,29 +1059,27 @@ interface SessionEnvironment {
|
|
|
1071
1059
|
variables: EnvironmentVariable[];
|
|
1072
1060
|
}
|
|
1073
1061
|
/**
|
|
1074
|
-
*
|
|
1075
|
-
*
|
|
1076
|
-
* outside the platform bounds fails validation
|
|
1077
|
-
* config) rather than being clamped silently.
|
|
1062
|
+
* The size and lifetime of the environment. Every field is optional. An
|
|
1063
|
+
* omitted field takes the platform default (2 vCPUs, 4096 MiB, a 4h timeout,
|
|
1064
|
+
* 10m idle). A value outside the platform bounds fails validation.
|
|
1078
1065
|
*
|
|
1079
|
-
* `memory`
|
|
1080
|
-
*
|
|
1081
|
-
* `
|
|
1082
|
-
* the environment is sized with.
|
|
1066
|
+
* `memory` accepts a string such as `8GB` or an object such as `{gb: 8}`.
|
|
1067
|
+
* `timeout` and `idle` accept a duration string such as `30m`, `8h`, or
|
|
1068
|
+
* `1h30m`.
|
|
1083
1069
|
*
|
|
1084
|
-
* `timeout` is the
|
|
1085
|
-
*
|
|
1086
|
-
* shortens a session; the cap matches the 1-hour validity of the session's
|
|
1087
|
-
* GitHub token).
|
|
1070
|
+
* `timeout` is the longest one message's work may run before it is stopped,
|
|
1071
|
+
* 1m to 22h, default 4h. The message ends `stopped` with reason `timeout`.
|
|
1088
1072
|
*
|
|
1089
|
-
*
|
|
1090
|
-
*
|
|
1091
|
-
*
|
|
1073
|
+
* `idle` is how long the environment stays awake after the agent finishes
|
|
1074
|
+
* with no message waiting, 10s to 1h, default 10m. Then it pauses, and the
|
|
1075
|
+
* next message resumes it. Only an interactive session pauses. A session
|
|
1076
|
+
* that runs once ends when its message ends.
|
|
1092
1077
|
*/
|
|
1093
1078
|
interface ComputeConfig1 {
|
|
1094
1079
|
cpu: number | null;
|
|
1080
|
+
idle: string | null;
|
|
1095
1081
|
memory: string | MemorySize | null;
|
|
1096
|
-
timeout: string |
|
|
1082
|
+
timeout: string | null;
|
|
1097
1083
|
}
|
|
1098
1084
|
/**
|
|
1099
1085
|
* Environment lifecycle scripts, in order: build_base, after_checkout,
|
|
@@ -2955,6 +2941,23 @@ declare class EllipsisSessions {
|
|
|
2955
2941
|
* Grant match patterns can further restrict access to individual resources.
|
|
2956
2942
|
*/
|
|
2957
2943
|
metrics(id: string): Promise<S['VMMetricsResponse']>;
|
|
2944
|
+
/**
|
|
2945
|
+
* Get Session Proxy
|
|
2946
|
+
*
|
|
2947
|
+
* The requests the session's environment sent to GitHub through
|
|
2948
|
+
* Ellipsis, newest first. Each is one `proxy_requests` row as stored.
|
|
2949
|
+
*
|
|
2950
|
+
* Required permissions: read:sessions.
|
|
2951
|
+
* API key: Supported.
|
|
2952
|
+
* CLI user token: Supported.
|
|
2953
|
+
* Session token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration. Only the token's own session.
|
|
2954
|
+
* Higher permission levels include lower levels: read < write < delete.
|
|
2955
|
+
* Grant match patterns can further restrict access to individual resources.
|
|
2956
|
+
*/
|
|
2957
|
+
proxy(id: string, options?: {
|
|
2958
|
+
limit?: number;
|
|
2959
|
+
cursor?: string | null;
|
|
2960
|
+
}): Promise<Page<S['ProxyRequest'], S['SessionProxyResponse']>>;
|
|
2958
2961
|
/**
|
|
2959
2962
|
* Get Session Records
|
|
2960
2963
|
*
|
package/dist/index.js
CHANGED
|
@@ -1688,6 +1688,29 @@ var EllipsisSessions = class {
|
|
|
1688
1688
|
const path = `/v1/sessions/${enc(id)}/metrics`;
|
|
1689
1689
|
return await this.transport.request("GET", path);
|
|
1690
1690
|
}
|
|
1691
|
+
/**
|
|
1692
|
+
* Get Session Proxy
|
|
1693
|
+
*
|
|
1694
|
+
* The requests the session's environment sent to GitHub through
|
|
1695
|
+
* Ellipsis, newest first. Each is one `proxy_requests` row as stored.
|
|
1696
|
+
*
|
|
1697
|
+
* Required permissions: read:sessions.
|
|
1698
|
+
* API key: Supported.
|
|
1699
|
+
* CLI user token: Supported.
|
|
1700
|
+
* Session token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration. Only the token's own session.
|
|
1701
|
+
* Higher permission levels include lower levels: read < write < delete.
|
|
1702
|
+
* Grant match patterns can further restrict access to individual resources.
|
|
1703
|
+
*/
|
|
1704
|
+
async proxy(id, options = {}) {
|
|
1705
|
+
const path = `/v1/sessions/${enc(id)}/proxy`;
|
|
1706
|
+
const query = buildQuery({ limit: options.limit, cursor: options.cursor });
|
|
1707
|
+
const response = await this.transport.request("GET", path, { query });
|
|
1708
|
+
return new Page(
|
|
1709
|
+
response,
|
|
1710
|
+
"proxy_requests",
|
|
1711
|
+
(cursor) => this.proxy(id, { ...options, cursor })
|
|
1712
|
+
);
|
|
1713
|
+
}
|
|
1691
1714
|
/**
|
|
1692
1715
|
* Get Session Records
|
|
1693
1716
|
*
|
package/dist/store/index.d.ts
CHANGED
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
import { s as CodexAgentMessage,
|
|
1
|
+
import { s as CodexAgentMessage, cS as SessionRecord, N as CodexFileChangeItem, L as CodexEvent, _ as CodexMcpToolCallItem, cg as SdkRecord, ct as Session, d5 as StreamFrame } from '../types-Dwyd1Aud.js';
|
|
2
2
|
|
|
3
3
|
type WorkPhase = 'queued' | 'preparing' | 'starting' | 'working';
|
|
4
4
|
interface MessageTiming {
|
package/dist/stream/index.d.ts
CHANGED