@gitterm/sdk 0.7.0 → 0.8.0

package/README.md

@@ -37,6 +37,8 @@ try {
     workspace,
     idempotencyKey: "review-pr-42",
     prompt: "Review PR #42 and fix the failing tests.",
+    // Optional files for the agent, e.g. a screenshot of the failure.
+    attachments: [{ name: "failure.png", mime: "image/png", data: base64Png }],
   });
   const result = await client.runs.result(run);
   console.log(result.finalText);

package/dist/direct/index.js

@@ -1827,7 +1827,12 @@ function createV2Runtime(target) {
     },
     async prompt(input) {
       await switchSessionOptions(input.sessionId, input.agent, input.model);
-      await call(client.session.prompt({ sessionID: input.sessionId, id: input.messageId, text: input.prompt }, options()));
+      await call(client.session.prompt({
+        sessionID: input.sessionId,
+        id: input.messageId,
+        text: input.prompt,
+        files: input.files
+      }, options()));
     },
     async abort(sessionID) {
       await call(client.session.interrupt({ sessionID }, options()));

package/dist/index.d.ts

@@ -6,4 +6,4 @@ export type { DeviceCodeInfo, LoginWithDeviceCodeOptions } from "./device-login.
 export { AgentRunError, GittermError, WorkspaceLifecycleError } from "./errors.js";
 export { createGittermWorkspaceClient, getWorkspaceEnvironment, type GittermWorkspaceClient, type WorkspaceClientOptions, type WorkspaceEnvironment, type WorkspacePort, type WorkspacePortVisibility, type WorkspaceSelf, } from "./workspace-client.js";
 export type { CredentialErrorCode, GittermErrorCode, WorkspaceLifecycleErrorCode, } from "./errors.js";
-export type { AgentPermissionRequest, AgentQuestion, AgentQuestionOption, AgentQuestionRequest, AgentRun, AgentRunCreateInput, AgentRunInputRequest, AgentRunMessage, AgentRunMessagePart, AgentRunReply, AgentRunStatus, AgentRunEvent, AgentRunResult, AgentRunReplyPermission, AgentRunReplyQuestion, RunResultOptions, RunRef, RunWaitOptions, RunWatchOptions, AgentType, AgentKey, AuthStatus, BuiltInAgentKey, CloudProvider, ProviderKey, Workspace, WorkspaceCreateInput, WorkspaceCreateResult, WorkspaceCatalog, WorkspaceEnsureRunningResult, WorkspaceHostingType, WorkspaceListOptions, WorkspaceListResult, WorkspaceRestartResult, WorkspaceRuntimeAccess, WorkspaceStatus, WorkspaceSetupStatus, ModelCredential, ModelProviderInfo, ModelCredentialSource, WorkspaceModelsInput, WorkspaceModelAccess, WorkspacePauseResult, WorkspaceTerminateResult, WorkspaceProviderSelection, Integration, IntegrationKey, IntegrationCategory, Connection, ConnectionKind, ConnectionStatus, ConnectionDetails, GitHubConnectionDetails, GoogleConnectionDetails, CreateConnectionInput, CreateConnectionResult, GitHubRepository, GitHubBranch, GoogleSetup, } from "./types.js";
+export type { AgentPermissionRequest, AgentQuestion, AgentQuestionOption, AgentQuestionRequest, AgentRun, AgentRunAttachment, AgentRunCreateInput, AgentRunInputRequest, AgentRunMessage, AgentRunMessagePart, AgentRunReply, AgentRunStatus, AgentRunEvent, AgentRunResult, AgentRunReplyPermission, AgentRunReplyQuestion, RunResultOptions, RunRef, RunWaitOptions, RunWatchOptions, AgentType, AgentKey, AuthStatus, BuiltInAgentKey, CloudProvider, ProviderKey, Workspace, WorkspaceCreateInput, WorkspaceCreateResult, WorkspaceCatalog, WorkspaceEnsureRunningResult, WorkspaceHostingType, WorkspaceListOptions, WorkspaceListResult, WorkspaceRestartResult, WorkspaceRuntimeAccess, WorkspaceStatus, WorkspaceSetupStatus, ModelCredential, ModelProviderInfo, ModelCredentialSource, WorkspaceModelsInput, WorkspaceModelAccess, WorkspacePauseResult, WorkspaceTerminateResult, WorkspaceProviderSelection, Integration, IntegrationKey, IntegrationCategory, Connection, ConnectionKind, ConnectionStatus, ConnectionDetails, GitHubConnectionDetails, GoogleConnectionDetails, CreateConnectionInput, CreateConnectionResult, GitHubRepository, GitHubBranch, GoogleSetup, } from "./types.js";

package/dist/types.d.ts

@@ -479,6 +479,14 @@ export type AgentRunListResult = {
         hasMore: boolean;
     };
 };
+export type AgentRunAttachment = {
+    /** Shown to the agent so the prompt can refer to the file by name. */
+    name?: string;
+    /** e.g. `image/png`. */
+    mime: string;
+    /** Base64-encoded content. */
+    data: string;
+};
 export type AgentRunCreateInput = {
     workspace: WorkspaceRef;
     /**
@@ -488,6 +496,11 @@ export type AgentRunCreateInput = {
      */
     idempotencyKey?: string;
     prompt: string;
+    /**
+     * Files the agent receives together with the prompt, e.g. screenshots for a vision model.
+     * At most 10 per run and 20 MB of base64 in total.
+     */
+    attachments?: AgentRunAttachment[];
     title?: string;
     agent?: string;
     /** OpenCode model in provider/model format. */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gitterm/sdk",
-  "version": "0.7.0",
+  "version": "0.8.0",
   "files": [
     "dist"
   ],