gemi 0.60.0 → 0.62.0

package/dist/ai/Schema.d.ts

@@ -0,0 +1,125 @@
+/**
+ * The schema layer for tool inputs, tool outputs and structured final answers.
+ *
+ * Two things have to come out of one declaration: a TypeScript type, so
+ * `execute(input)` is typed at the call site and the result is typed in the
+ * browser, and a JSON Schema, because that is what the model is actually shown.
+ * A phantom `Schema<T>` gives the first and nothing of the second, and a
+ * hand-written JSON Schema next to a hand-written type gives both and lets them
+ * drift. So the builder below is the single source, and `Infer` reads the type
+ * back off it.
+ *
+ * Everything here is deliberately narrower than JSON Schema. OpenAI's strict
+ * structured output only accepts a subset — every property listed in
+ * `required`, `additionalProperties: false` on every object, no patterns, no
+ * `oneOf` at the root — and a builder that cannot express the rejected parts is
+ * better than one that lets you write a schema the API refuses at runtime.
+ */
+export type JSONSchema = {
+    type?: string | string[];
+    description?: string;
+    enum?: readonly (string | number)[];
+    const?: string | number | boolean;
+    properties?: Record<string, JSONSchema>;
+    required?: readonly string[];
+    additionalProperties?: false;
+    items?: JSONSchema;
+    anyOf?: readonly JSONSchema[];
+};
+declare const OUTPUT: unique symbol;
+declare const OPTIONAL: unique symbol;
+/**
+ * `T` is carried in a phantom property rather than a real one: it exists only
+ * for inference, and a real field would show up on the object the app writes.
+ */
+export interface Schema<T> {
+    readonly [OUTPUT]: T;
+    /** The JSON Schema handed to the provider. */
+    toJSONSchema(): JSONSchema;
+    /**
+     * Parses a value coming back from the model. Tool arguments arrive as a JSON
+     * string the model generated, so they are untrusted in exactly the way a
+     * request body is: shape-checked before `execute` ever sees them.
+     */
+    parse(value: unknown): T;
+    safeParse(value: unknown): {
+        ok: true;
+        value: T;
+    } | {
+        ok: false;
+        errors: string[];
+    };
+}
+/**
+ * A schema whose key may be left out of the object containing it.
+ *
+ * Marked with a property rather than detected from the output type, because
+ * `undefined extends T` — the obvious test — is true of *everything* when
+ * `strictNullChecks` is off, which is how this package and plenty of apps
+ * compile. That version made every field of every tool optional, and did it
+ * quietly: the JSON Schema was still right, so only the TypeScript types lied.
+ */
+export interface OptionalSchema<T> extends Schema<T | undefined> {
+    readonly [OPTIONAL]: true;
+}
+export type AnySchema = Schema<any>;
+export type Infer<S> = S extends Schema<infer T> ? T : never;
+/**
+ * Collapses a type into one flat object.
+ *
+ * `ShapeOutput` builds its result as an intersection of two mapped types, one
+ * required and one optional, and that intersection is what every hover, every
+ * error message and every type assertion would otherwise show. The difference
+ * is between an app reading `{ command: string; cwd?: string }` and reading two
+ * mapped types joined by an ampersand.
+ *
+ * It also drops `readonly`, which the mapped types copy from the shape literal
+ * — `s.object({ ... })` infers that literal as `const` to keep the keys, and a
+ * tool has no reason to receive an immutable input because of how its schema
+ * was written down.
+ */
+type Flatten<T> = {
+    -readonly [K in keyof T]: T[K];
+};
+type ShapeOutput<S extends Record<string, AnySchema>> = Flatten<{
+    [K in keyof S as S[K] extends OptionalSchema<any> ? never : K]: Infer<S[K]>;
+} & {
+    [K in keyof S as S[K] extends OptionalSchema<any> ? K : never]?: Infer<S[K]>;
+}>;
+interface SchemaBuilder<T> extends Schema<T> {
+    /**
+     * The description is not documentation — it is the only prose the model gets
+     * about a field, and it is the difference between a tool that is called
+     * correctly and one that is not.
+     */
+    describe(description: string): this;
+    /**
+     * Strict mode has no notion of an omitted key: every property must appear in
+     * `required`. So `optional()` emits a nullable union and the model is told to
+     * send `null`, while the TypeScript type says `| undefined` and the parsed
+     * value drops the key. The asymmetry is the point — it is what lets an app
+     * write ordinary optional fields against an API that forbids them.
+     */
+    optional(): OptionalSchemaBuilder<T>;
+    nullable(): SchemaBuilder<T | null>;
+}
+interface OptionalSchemaBuilder<T> extends SchemaBuilder<T | undefined>, OptionalSchema<T> {
+}
+export declare const s: {
+    string(): SchemaBuilder<string>;
+    number(): SchemaBuilder<number>;
+    boolean(): SchemaBuilder<boolean>;
+    literal<const L extends string | number | boolean>(value: L): SchemaBuilder<L>;
+    /** Modelled as a JSON Schema `enum`, which strict mode does support. */
+    enum<const L extends readonly [string, ...string[]]>(values: L): SchemaBuilder<L[number]>;
+    object<const S extends Record<string, AnySchema>>(shape: S): SchemaBuilder<ShapeOutput<S>>;
+    array<const S extends AnySchema>(item: S): SchemaBuilder<Infer<S>[]>;
+    /**
+     * `anyOf` of object schemas, discriminated by a literal member. Left in
+     * because tool outputs are frequently a success/failure pair, and modelling
+     * that as one object with everything optional is worse for the model.
+     */
+    union<const S extends readonly [AnySchema, AnySchema, ...AnySchema[]]>(members: S): SchemaBuilder<Infer<S[number]>>;
+};
+export {};
+//# sourceMappingURL=Schema.d.ts.map

package/dist/ai/Schema.d.ts.map

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

package/dist/ai/Schema.test-d.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=Schema.test-d.d.ts.map

package/dist/ai/Schema.test-d.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Schema.test-d.d.ts","sourceRoot":"","sources":["../../ai/Schema.test-d.ts"],"names":[],"mappings":""}

package/dist/ai/client/index.d.ts

@@ -0,0 +1,24 @@
+/**
+ * `gemi/ai/client` — the browser half of the agent module.
+ *
+ * Separate from `gemi/ai` because that entry reaches the providers, the tool
+ * registry and `signing.ts`; the long form of the argument is at the top of
+ * `ai/index.ts`. The short form: a barrel is evaluated, not browsed, so the
+ * only reliable way to keep an API key and a tool's `execute` out of a client
+ * bundle is for the module the client imports to have no path to them.
+ *
+ * It does not, and nothing here is a compromise to keep it that way. Following
+ * every import from this file reaches `useChat.tsx`, the SSE decoder, the frame
+ * reducer, `ai/types.ts` (which imports nothing) and React. The agent's tool
+ * types still arrive fully typed, because they travel as *types* on the route's
+ * `RPC` entry rather than as a value this file would have to import.
+ *
+ * The sibling modules in this directory — `reducer.ts` and `sse.ts` — are
+ * `useChat`'s internals and stay unexported. They are pure functions over
+ * frames, which is why they are separately testable, but an app that reaches
+ * for `applyFrame` is reimplementing the hook.
+ */
+export { useChat } from "../useChat";
+export type { AgentAttachBody, AgentRequestBody, AgentStopBody, ChatStatus, UseChatParams, UseChatResult, } from "../useChat";
+export type { AgentContentPart, AgentError, AgentErrorCode, AgentMessage, AgentStreamEvent, AgentStreamFrame, ClientToolResult, ClientTurn, FilePart, FinishReason, NestedRun, OutputPart, PendingToolCall, ReasoningPart, TextPart, ToolCallPart, ToolResultPart, ToolShape, ToolShapes, Usage, } from "../types";
+//# sourceMappingURL=index.d.ts.map

package/dist/ai/client/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../ai/client/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AACrC,YAAY,EACV,eAAe,EACf,gBAAgB,EAChB,aAAa,EACb,UAAU,EACV,aAAa,EACb,aAAa,GACd,MAAM,YAAY,CAAC;AAMpB,YAAY,EACV,gBAAgB,EAChB,UAAU,EACV,cAAc,EACd,YAAY,EACZ,gBAAgB,EAChB,gBAAgB,EAChB,gBAAgB,EAChB,UAAU,EACV,QAAQ,EACR,YAAY,EAGZ,SAAS,EACT,UAAU,EACV,eAAe,EACf,aAAa,EACb,QAAQ,EACR,YAAY,EACZ,cAAc,EACd,SAAS,EACT,UAAU,EACV,KAAK,GACN,MAAM,UAAU,CAAC"}