palbase 0.4.0 → 0.5.1

package/types/internal/src/modules/ai.d.ts

@@ -93,6 +93,7 @@ export type Chat = {
      * Its title.
      */
     title: string;
+    workspace?: ChatWorkspace;
 };
 /**
  * Chats, the newest first (100 at most).
@@ -152,6 +153,19 @@ export type ChatMessage = {
      */
     text: string;
 };
+/**
+ * One repository of a chat's workspace.
+ */
+export type ChatRepo = {
+    /**
+     * The branch it is checked out at and pushed to (the repository's default unless said).
+     */
+    branch?: string;
+    /**
+     * The project's name for the repository (PUT /ai/repos/{name}).
+     */
+    repo: string;
+};
 /**
  * A chat to start.
  */
@@ -179,6 +193,20 @@ export type ChatRequest = {
      * Its title (256 bytes at most).
      */
     title?: string;
+    workspace?: ChatWorkspace;
+};
+/**
+ * The project's repositories a chat works in, each at a branch: its turns run on a machine of the platform's with them checked out, and what its agent commits is pushed to that branch.
+ */
+export type ChatWorkspace = {
+    /**
+     * Lets the agent push its commits to the branches without a person's yes — the server's choice for the chat: its members' messages then reach the repository. Without it a push waits for a member's approval.
+     */
+    auto_push?: boolean;
+    /**
+     * 1 to 8 of the project's repositories, each once.
+     */
+    repos: ChatRepo[];
 };
 /**
  * A decision made.
@@ -609,6 +637,7 @@ export type MessageRequest = {
      * The member the server writes as (the server's alone).
      */
     as?: string;
+    budget?: TurnBudget;
     /**
      * The writer's own id for it: sent again — a retry, a second tab — it is the same message, delivered once.
      */
@@ -687,6 +716,54 @@ export type ProviderList = {
      */
     providers: Provider[];
 };
+/**
+ * A GitHub repository the project's chats work in, by the project's name for it; the project's backend gives its tokens (the framework's ai.repo), asked at each clone and each push.
+ */
+export type Repo = {
+    /**
+     * The project's machine that gives its tokens.
+     */
+    backend: string;
+    /**
+     * When it was put first.
+     */
+    created_at: string;
+    /**
+     * The branch a workspace takes when it names none.
+     */
+    default_branch: string;
+    /**
+     * The project's name for it.
+     */
+    name: string;
+    /**
+     * The GitHub repository, owner/name.
+     */
+    repository: string;
+};
+/**
+ * The project's repositories.
+ */
+export type RepoPage = {
+    repos: Repo[];
+};
+/**
+ * A repository the project's chats work in.
+ */
+export type RepoRequest = {
+    /**
+     * The project's machine whose framework gives the repository's tokens (backend unless said).
+     */
+    backend?: string;
+    /**
+     * The branch a workspace takes when it names none (main unless said).
+     */
+    default_branch?: string;
+    /**
+     * The GitHub repository, owner/name.
+     */
+    repository: string;
+};
 /**
  * A response.
  */
@@ -1027,6 +1104,83 @@ export type ToolRef = {
      */
     source: "backend" | "https" | "mcp" | "client";
 };
+/**
+ * One artifact a turn's agent published.
+ */
+export type TurnArtifact = {
+    /**
+     * Its digest (sha256:<hex>).
+     */
+    checksum: string;
+    /**
+     * When it was published.
+     */
+    created_at: string;
+    /**
+     * The artifact.
+     */
+    id: string;
+    /**
+     * What it is to the engine, when it says.
+     */
+    logical_type?: string;
+    /**
+     * Its media type, as published.
+     */
+    media_type: string;
+    /**
+     * Its size.
+     */
+    size_bytes: number;
+};
+/**
+ * A turn's artifacts.
+ */
+export type TurnArtifacts = {
+    artifacts: TurnArtifact[];
+};
+/**
+ * What the turn a message starts may cost at most, its subagents' spend counted (the server's alone): past it the engine stops the turn. A message delivered into a turn already running takes that turn's.
+ */
+export type TurnBudget = {
+    /**
+     * US dollars, more than 0 and at most 100000; rounded up to the cent.
+     */
+    max_cost_usd: number;
+};
+/**
+ * What one turn of a chat cost so far: its model calls and its subagents', at the engine's frozen rates.
+ */
+export type TurnCost = {
+    /**
+     * The chat.
+     */
+    chat_id: string;
+    /**
+     * What they cost, in billionths of a US dollar.
+     */
+    cost_nano_usd: number;
+    /**
+     * Nothing more of the turn's use can be settled: false while it or a subagent of it runs.
+     */
+    final: boolean;
+    /**
+     * Input tokens of the turn and its subagents.
+     */
+    input_tokens: number;
+    /**
+     * Output tokens of the turn and its subagents.
+     */
+    output_tokens: number;
+    /**
+     * The turn.
+     */
+    response_id: string;
+    /**
+     * A model of the turn has no price: the cost is a lower bound.
+     */
+    unpriced: boolean;
+};
 /**
  * A page of uses.
  */
@@ -1089,6 +1243,61 @@ export type Use = {
      */
     response_id: string | null;
 };
+/**
+ * Text for the voice.
+ */
+export type VoiceCommand = {
+    /**
+     * The delegated voice part this answers (speak).
+     */
+    delegation_id?: string;
+    /**
+     * What it is given (16 KiB at most).
+     */
+    text: string;
+    /**
+     * speak (say this), know (keep it in mind) or instruct (behave so).
+     */
+    type: "speak" | "know" | "instruct";
+};
+/**
+ * Starts the chat's live voice.
+ */
+export type VoiceRequest = {
+    /**
+     * The app's WebRTC offer (an SDP).
+     */
+    sdp: string;
+    /**
+     * The voice (the provider's default unless said).
+     */
+    voice?: string;
+};
+/**
+ * A chat's live voice.
+ */
+export type VoiceSession = {
+    /**
+     * The chat.
+     */
+    chat_id: string;
+    /**
+     * The voice session.
+     */
+    id: string;
+    /**
+     * The provider's WebRTC answer, for the app's peer connection (on start).
+     */
+    sdp?: string;
+    /**
+     * How long it lasted (on close).
+     */
+    seconds: number;
+    /**
+     * active, or closed.
+     */
+    status?: string;
+};
 /** The events this module sends the project's webhooks (x-palbase-events), by type: each one's payload, the event's data. */
 export interface Events {
     /**
@@ -1293,6 +1502,80 @@ export declare function client(t: Transport): {
         body: ToolOutput; /** Stops the call: the request in flight, a wait before a retry, a proof-of-work being solved. */
         signal?: AbortSignal;
     }): Promise<Reply<200, ToolOutputAccepted>>;
+    /**
+     * A turn's artifacts
+     *
+     * What the turn's agent published as its output (palai.artifact.publish) — a build's product from the workspace's Mac, a screenshot, a report — kept in the project's own storage. The chat's members and the project's server read it, as they read the chat.
+     */
+    listChatTurnArtifacts(input: {
+        path: {
+            chat_id: string; /** The turn: a message's response_id, or a turn event's. */
+            response_id: string;
+        }; /** Stops the call: the request in flight, a wait before a retry, a proof-of-work being solved. */
+        signal?: AbortSignal;
+    }): Promise<Reply<200, TurnArtifacts>>;
+    /**
+     * An artifact of a turn
+     *
+     * One artifact of the turn, its bytes as the agent published them (an attachment, never a page). One the turn did not publish is not found (404 artifact_not_found).
+     */
+    getChatTurnArtifact(input: {
+        path: {
+            chat_id: string; /** The turn: a message's response_id, or a turn event's. */
+            response_id: string; /** The artifact: an id of the turn's artifacts. */
+            artifact_id: string;
+        }; /** Stops the call: the request in flight, a wait before a retry, a proof-of-work being solved. */
+        signal?: AbortSignal;
+    }): Promise<Reply<200, Response>>;
+    /**
+     * What a turn of a chat cost
+     *
+     * What a turn of the chat cost so far, its subagents' calls counted — while it runs too (final false) — or what one subagent's work in it cost (an agent event's response_id). The project's server's: a member's key is refused (403 server_only).
+     */
+    getChatTurnCost(input: {
+        path: {
+            chat_id: string; /** The turn: a message's response_id, or a turn event's. */
+            response_id: string;
+        }; /** Stops the call: the request in flight, a wait before a retry, a proof-of-work being solved. */
+        signal?: AbortSignal;
+    }): Promise<Reply<200, TurnCost>>;
+    /**
+     * Start a chat's voice
+     *
+     * Starts the chat's live voice: the app's WebRTC offer in, the answer out — the audio then goes between the app and the platform's voice provider. What is said either way is in the chat's stream as voice parts (transcripts); a task the voice hands over is a voice part of kind delegated. One voice a chat at a time (409 voice_active). A user starts at most 5 voices an hour in the project's chats (429 too_many_voices, with Retry-After) — each is the project's spend while it lasts; the server's starts are not counted.
+     */
+    startChatVoice(input: {
+        path: {
+            chat_id: string;
+        };
+        body: VoiceRequest; /** Stops the call: the request in flight, a wait before a retry, a proof-of-work being solved. */
+        signal?: AbortSignal;
+    }): Promise<Reply<201, VoiceSession>>;
+    /**
+     * Close a chat's voice
+     *
+     * Ends the chat's voice; the answer says how long it lasted.
+     */
+    closeChatVoice(input: {
+        path: {
+            chat_id: string; /** The voice session. */
+            voice_id: string;
+        }; /** Stops the call: the request in flight, a wait before a retry, a proof-of-work being solved. */
+        signal?: AbortSignal;
+    }): Promise<Reply<200, VoiceSession>>;
+    /**
+     * Tell a chat's voice
+     *
+     * The server's alone (a member is answered 403 server_only): a member's words would be the agent's own to every other member of the chat. Gives the chat's voice text: speak says it, know keeps it in mind, instruct changes how it behaves — speak with a delegation_id answers a task it handed over.
+     */
+    commandChatVoice(input: {
+        path: {
+            chat_id: string; /** The voice session. */
+            voice_id: string;
+        };
+        body: VoiceCommand; /** Stops the call: the request in flight, a wait before a retry, a proof-of-work being solved. */
+        signal?: AbortSignal;
+    }): Promise<Reply<202, VoiceSession>>;
     /**
      * Turn texts into vectors
      *
@@ -1407,6 +1690,37 @@ export declare function client(t: Transport): {
         }; /** Stops the call: the request in flight, a wait before a retry, a proof-of-work being solved. */
         signal?: AbortSignal;
     }): Promise<Reply<204, undefined>>;
+    /**
+     * The project's repositories
+     *
+     * The repositories the project's chats work in.
+     */
+    listRepos(input?: {
+        signal?: AbortSignal;
+    }): Promise<Reply<200, RepoPage>>;
+    /**
+     * Put a repository
+     *
+     * Puts a GitHub repository the project's chats work in. Its tokens come from the project's backend (the framework's ai.repo), asked at each clone and each push — none is kept.
+     */
+    putRepo(input: {
+        path: {
+            name: string;
+        };
+        body: RepoRequest; /** Stops the call: the request in flight, a wait before a retry, a proof-of-work being solved. */
+        signal?: AbortSignal;
+    }): Promise<Reply<200, Repo>>;
+    /**
+     * Delete a repository
+     *
+     * A chat's workspace checks it out no more.
+     */
+    deleteRepo(input: {
+        path: {
+            name: string;
+        }; /** Stops the call: the request in flight, a wait before a retry, a proof-of-work being solved. */
+        signal?: AbortSignal;
+    }): Promise<Reply<204, undefined>>;
     /**
      * Ask a model
      *

package/types/internal/src/modules/auth.d.ts

@@ -797,6 +797,28 @@ export type AppleWebCredentials = {
 export type ApproveRecoveryRequest = {
     token: string;
 };
+export type AssetLinkStatement = {
+    /**
+     * `delegate_permission/common.get_login_creds`
+     */
+    relation: string[];
+    target: AssetLinkTarget;
+};
+export type AssetLinkTarget = {
+    namespace: "android_app";
+    /**
+     * The app's application ID
+     */
+    package_name: string;
+    /**
+     * The SHA-256 of each certificate the app is signed with, as Play Console prints it
+     */
+    sha256_cert_fingerprints: string[];
+};
+/**
+ * Digital Asset Links statements, one per Android app with a signing certificate.
+ */
+export type AssetLinks = AssetLinkStatement[];
 /**
  * One request's App Attest evidence and the request it claims to be bound to.
  */
@@ -1428,6 +1450,10 @@ export type ErrorResponse = {
      * Human-readable explanation
      */
     error_description: string;
+    /**
+     * On a refused configuration (invalid_auth_config): each field refused, by its JSON Pointer in the request body, and why.
+     */
+    field_errors?: FieldError[];
     /**
      * Correlation ID for log/audit lookup
      */
@@ -1444,6 +1470,19 @@ export type ErrorResponse = {
 export type ExchangeCustomTokenRequest = {
     custom_token: string;
 };
+/**
+ * A field the request body was refused for.
+ */
+export type FieldError = {
+    /**
+     * Why the field was refused.
+     */
+    message: string;
+    /**
+     * The field, as a JSON Pointer into the request body (/providers/google/client_id).
+     */
+    pointer: string;
+};
 export type ForbiddenOrPowRequired = PowRequiredResponse | ErrorResponse;
 /**
  * A blocking hook: for its before.* event, auth calls the URL and waits for the verdict.
@@ -2078,6 +2117,31 @@ export type OIDCDiscovery = {
     token_endpoint_auth_signing_alg_values_supported?: string[];
     userinfo_endpoint: string;
 };
+/**
+ * Where the page sends the browser: the CLI's listener, with the one-time code and the state. The CLI redeems the code at /oauth/token with its verifier and the same redirect_uri.
+ */
+export type OwnerCLICode = {
+    redirect_to: string;
+    expires_in: number;
+};
+/**
+ * The CLI's PKCE challenge (RFC 7636 §4.2).
+ */
+export type OwnerCLICodeRequest = {
+    /**
+     * base64url of the SHA-256 of the CLI's verifier
+     */
+    code_challenge: string;
+    code_challenge_method: "S256";
+    /**
+     * The CLI's listener (RFC 8252 §7.3): a loopback IP literal and a port from 1024 to 65535.
+     */
+    redirect_uri: string;
+    /**
+     * The CLI's state, sent back to its listener.
+     */
+    state: string;
+};
 /**
  * Form-encoded RFC 9126 PAR parameters. Additional fields are passed through to the AS.
  */
@@ -3371,53 +3435,6 @@ export type WebAuthnSignupBeginResponse = {
      */
     user_id: string;
 };
-/**
- * The CLI's PKCE challenge (RFC 7636 §4.2).
- */
-export type OwnerCLICodeRequest = {
-    /**
-     * base64url of the SHA-256 of the CLI's verifier
-     */
-    code_challenge: string;
-    code_challenge_method: "S256";
-    /**
-     * The CLI's listener (RFC 8252 §7.3): a loopback IP literal and a port from 1024 to 65535.
-     */
-    redirect_uri: string;
-    /**
-     * The CLI's state, sent back to its listener.
-     */
-    state: string;
-};
-/**
- * Where the page sends the browser: the CLI's listener, with the one-time code and the state. The CLI redeems the code at /oauth/token with its verifier and the same redirect_uri.
- */
-export type OwnerCLICode = {
-    redirect_to: string;
-    expires_in: number;
-};
-/**
- * Digital Asset Links statements, one per Android app with a signing certificate.
- */
-export type AssetLinks = AssetLinkStatement[];
-export type AssetLinkStatement = {
-    /**
-     * `delegate_permission/common.get_login_creds`
-     */
-    relation: string[];
-    target: AssetLinkTarget;
-};
-export type AssetLinkTarget = {
-    namespace: "android_app";
-    /**
-     * The app's application ID
-     */
-    package_name: string;
-    /**
-     * The SHA-256 of each certificate the app is signed with, as Play Console prints it
-     */
-    sha256_cert_fingerprints: string[];
-};
 /** Palbase Auth API */
 export declare function client(t: Transport): {
     /**