@truefoundry/trueforge-ui 0.3.0-rc.0 → 0.3.0-rc.10

package/dist/plugins/trueforge-agent-server-adapter/index.d.ts

@@ -1,8 +1,174 @@
-import { T as TrueFoundryServer } from '../../createTrueFoundryServer-B72bU-J7.js';
+import { T as TrueFoundryServer } from '../../createTrueFoundryServer-B_FYhSdn.js';
 import * as _truefoundry_assistant_ui_runtime from '@truefoundry/assistant-ui-runtime';
-import { AgentSpec, AgentBuilderServer, ModelSelection as ModelSelection$1, ConnectorCatalogServer as ConnectorCatalogServer$1, ToolBase as ToolBase$1, ConnectorAuth as ConnectorAuth$1, ConnectorAuthPublic as ConnectorAuthPublic$1, ConnectorBase as ConnectorBase$1, ConnectorCatalogEntry as ConnectorCatalogEntry$1, CreateConnectorRequest as CreateConnectorRequest$1, UpdateConnectorRequest as UpdateConnectorRequest$1, ModelCatalogServer as ModelCatalogServer$1, ModelEntry as ModelEntry$1, ModelProviderBase as ModelProviderBase$1, ModelProviderCatalogEntry as ModelProviderCatalogEntry$1, CreateModelProviderRequest as CreateModelProviderRequest$1, UpdateModelProviderRequest as UpdateModelProviderRequest$1, SandboxProviderConfig, SandboxCatalogServer as SandboxCatalogServer$1, SandboxProviderListEntry as SandboxProviderListEntry$1, SandboxProviderBase, SkillCatalogServer as SkillCatalogServer$1, DefinedSkill, SkillConfigBase as SkillConfigBase$1, AgentChatServer, CatalogServer } from '@truefoundry/assistant-ui-runtime/server';
+import { AgentSpec as AgentSpec$1, AgentMetricsServer as AgentMetricsServer$1, AgentSessionsServer as AgentSessionsServer$1, AgentBuilderServer, ModelSelection as ModelSelection$1, ConnectorCatalogServer as ConnectorCatalogServer$1, ToolBase as ToolBase$1, ConnectorAuth as ConnectorAuth$1, ConnectorAuthPublic as ConnectorAuthPublic$1, ConnectorBase as ConnectorBase$1, ConnectorCatalogEntry as ConnectorCatalogEntry$1, CreateConnectorRequest as CreateConnectorRequest$1, UpdateConnectorRequest as UpdateConnectorRequest$1, ModelCatalogServer as ModelCatalogServer$1, ModelEntry as ModelEntry$1, ModelProviderBase as ModelProviderBase$1, ModelProviderCatalogEntry as ModelProviderCatalogEntry$1, CreateModelProviderRequest as CreateModelProviderRequest$1, UpdateModelProviderRequest as UpdateModelProviderRequest$1, SandboxProviderConfig, SandboxCatalogServer as SandboxCatalogServer$1, SandboxProviderListEntry as SandboxProviderListEntry$1, SandboxProviderBase, SkillCatalogServer as SkillCatalogServer$1, DefinedSkill, SkillConfigBase as SkillConfigBase$1, AgentChatServer, Session, CreateSessionRequest, PermissionsServer, ScheduleServer as ScheduleServer$1, CatalogServer } from '@truefoundry/assistant-ui-runtime/server';
 import { TrueForge, TrueForgeApi } from '@truefoundry/trueforge-sdk';
 
+/**
+ * Runtime-owned turn/stream event protocol.
+ *
+ * Hosts must emit events matching these shapes. The TFY adapter maps
+ * truefoundry-gateway-sdk events 1:1 onto these types.
+ */
+
+interface ToolCallFunction {
+    name: string;
+    arguments: string;
+}
+type ToolInfo = {
+    type: "truefoundry-system";
+    name: string;
+} | {
+    type: "mcp";
+    serverId: string;
+    serverName: string;
+    name: string;
+} | {
+    type: string;
+    name?: string;
+    [key: string]: unknown;
+};
+interface ToolCall {
+    id: string;
+    type: "function";
+    function: ToolCallFunction;
+    toolInfo?: ToolInfo;
+    providerSpecificFields?: Record<string, unknown>;
+}
+/** Ref used by approval/response-required events. */
+interface ToolCallRef {
+    id: string;
+    sourceEventId: string;
+}
+type ModelMessageContentPart = {
+    type: "text";
+    text: string;
+} | {
+    type: "refusal";
+    refusal: string;
+} | {
+    type: "image_url";
+    image_url: {
+        url: string;
+    };
+};
+interface ModelMessageEvent {
+    type: "model.message";
+    id: string;
+    threadId: string;
+    content?: string | ModelMessageContentPart[] | null;
+    name?: string;
+    refusal?: string | null;
+    reasoningContent?: string;
+    toolCalls?: ToolCall[];
+    finishReason?: string | null;
+    createdAt: string;
+    usage?: unknown;
+}
+interface ToolResponseEvent {
+    type: "tool.response";
+    id: string;
+    threadId: string;
+    toolCallId: string;
+    content: string;
+    createdAt: string;
+}
+interface ToolApprovalRequiredEvent {
+    type: "tool.approval_required";
+    id: string;
+    createdAt: string;
+    threadId: string;
+    toolCalls: ToolCallRef[];
+}
+interface ToolResponseRequiredEvent {
+    type: "tool.response_required";
+    id: string;
+    createdAt: string;
+    threadId: string;
+    toolCalls: ToolCallRef[];
+}
+interface AgentInfo {
+    type?: string;
+    name: string;
+    input: string;
+    model?: string;
+}
+interface AgentParent {
+    threadId: string;
+    toolCallId: string;
+}
+interface ThreadCreatedEvent {
+    type: "thread.created";
+    id: string;
+    threadId: string;
+    title: string;
+    agentInfo: AgentInfo;
+    parent: AgentParent;
+    createdAt: string;
+}
+interface ThreadDoneEvent {
+    type: "thread.done";
+    id: string;
+    threadId: string;
+    title?: string;
+    createdAt: string;
+    state?: unknown;
+}
+interface McpServerAuthInfo {
+    id: string;
+    name: string;
+    authUrl: string;
+}
+interface McpAuthRequiredEvent {
+    type: "mcp.auth_required";
+    id: string;
+    createdAt: string;
+    threadId?: string | null;
+    mcpServers: McpServerAuthInfo[];
+}
+interface SandboxCreatedEvent {
+    type: "sandbox.created";
+    id: string;
+    createdAt: string;
+    sandboxId: string;
+    threadId: string | null;
+}
+interface McpInitializeEvent {
+    type: "mcp.initialize";
+    id: string;
+    createdAt: string;
+    threadId: string | null;
+    [key: string]: unknown;
+}
+interface TurnCreatedEvent {
+    type: "turn.created";
+    id: string;
+    turnId: string;
+    previousTurnId?: string | null;
+    input?: TurnInputItem[];
+    state?: {
+        status: "running";
+    };
+    createdAt: string;
+    threadId?: string | null;
+}
+interface TurnDoneEvent {
+    type: "turn.done";
+    id: string;
+    state: Exclude<TurnState, {
+        status: "running";
+    }>;
+    createdAt: string;
+    threadId?: string | null;
+}
+/** Events stored in fold buckets (non-delta, non-turn-lifecycle). */
+type TurnEvent = ModelMessageEvent | ToolResponseEvent | ThreadCreatedEvent | ThreadDoneEvent | McpAuthRequiredEvent | McpInitializeEvent | SandboxCreatedEvent | ToolApprovalRequiredEvent | ToolResponseRequiredEvent;
+type ActionRequiredEvent = ToolApprovalRequiredEvent | ToolResponseRequiredEvent | McpAuthRequiredEvent;
+/** Session-level event item from `listEvents`. */
+interface SessionEventItem {
+    turnId: string;
+    event: TurnCreatedEvent | TurnDoneEvent | TurnEvent;
+}
+
 /**
  * FE-owned AgentUIServer contract.
  *
@@ -17,17 +183,181 @@ interface ProviderEntry {
 }
 interface ModelProperties {
     reasoningEfforts?: string[];
+    contextLength?: number;
+    maxOutputTokens?: number;
 }
-/** Model selector row. Host extends for apiModel, modelId, pricing, etc. */
+/** Model selector row. Host extends for apiModel, modelId, etc. */
 interface ModelSelectorEntry<TProvider extends ProviderEntry = ProviderEntry, TProperties extends ModelProperties = ModelProperties> {
     name: string;
     id: string;
     provider: TProvider;
     properties: TProperties;
 }
+/** Who created a resource. Optional on list DTOs when the host does not track creators. */
+interface CreatedBySubject {
+    subjectId: string;
+    subjectType: string;
+    subjectDisplayName: string;
+}
+/**
+ * Mounts written to AgentSpec.skills[] / AgentSpec.mcpServers[].
+ *
+ * These are opaque to the runtime — it stores and forwards them but never reads
+ * a field, and the backend owns the shape (the gateway identifies a skill by
+ * `fqn`, with no `id` or `name` anywhere). So the base constrains only that a
+ * mount is an object; hosts intersect their concrete mount type over it, as
+ * `TfySkillMount` / `TfyMcpServerMount` do in the gateway adapter.
+ *
+ * Naming a field here would not just be unread, it would be wrong: a base with
+ * required fields rejects the backend's own payloads, and one with only optional
+ * fields is a weak type, which TypeScript rejects for a source that shares no
+ * property with it — the gateway's registry skill shares none.
+ */
+type SkillMount = object;
+type McpServerMount = object;
+interface ModelParams {
+    maxTokens?: number;
+    reasoningEffort?: string;
+    temperature?: number;
+    topP?: number;
+    topK?: number;
+    parallelToolCalls?: boolean;
+}
+interface Model {
+    name: string;
+    params?: ModelParams;
+}
+interface AgentCapabilityConfig {
+    enabled?: boolean;
+}
+interface AgentSandboxConfig extends AgentCapabilityConfig {
+    fileDownloads?: boolean;
+}
+interface AgentInputTokensCompactionTrigger {
+    type: "input_tokens";
+    value: number;
+}
+interface AgentCompactionConfig extends AgentCapabilityConfig {
+    trigger?: AgentInputTokensCompactionTrigger;
+}
+interface AgentContextManagementConfig {
+    compaction?: AgentCompactionConfig;
+    largeToolResponse?: AgentCapabilityConfig;
+}
+interface AgentRuntimeConfig {
+    iterationLimit?: number;
+    sandbox?: AgentSandboxConfig;
+    contextManagement?: AgentContextManagementConfig;
+    generativeUi?: AgentCapabilityConfig;
+    dynamicSubAgents?: AgentCapabilityConfig;
+    askUserQuestions?: AgentCapabilityConfig;
+}
+/**
+ * SDK-owned agent definition — fields the FE reads/writes.
+ * Host widens `model` / `skills` / `mcpServers` / `config` via type params,
+ * and adds extra fields via `TSpec extends AgentSpec<...>`.
+ */
+interface AgentSpec<TModel extends Model = Model, TSkill extends SkillMount = SkillMount, TMcp extends McpServerMount = McpServerMount, TConfig extends AgentRuntimeConfig = AgentRuntimeConfig> {
+    model: TModel;
+    skills?: TSkill[];
+    mcpServers?: TMcp[];
+    config?: TConfig;
+    instructions?: string;
+    variables?: Record<string, string>;
+}
+interface ListResult<T> {
+    data: T[];
+    nextPageToken?: string;
+}
+type ListSessionsOrder = "asc" | "desc";
+type PageParams = {
+    limit?: number;
+    order?: ListSessionsOrder;
+    pageToken?: string;
+};
+interface ListSessionsParams extends PageParams {
+    /** Host-owned agent identity filter. Omit for all sessions (current user). */
+    agentId?: string;
+    /**
+     * When true, only sessions created by the authenticated subject.
+     * Omit to include managed-agent visibility where the host supports it.
+     */
+    createdByMe?: boolean;
+    /** Inclusive lower bound on session activity (ISO-8601). */
+    startTimestamp?: string;
+    /** Inclusive upper bound on session activity (ISO-8601). */
+    endTimestamp?: string;
+}
+type UserMessageContent = string | Array<{
+    type: "text";
+    text: string;
+} | {
+    type: "file";
+    name: string;
+    data: string;
+}>;
+interface UserMessage {
+    type: "user.message";
+    content: UserMessageContent;
+}
+type ApprovalDecision = {
+    status: "allow";
+} | {
+    status: "deny";
+    reason?: string;
+};
+interface UserToolApprovalEvent {
+    type: "user.tool_approval";
+    threadId: string;
+    toolCallId: string;
+    approval: ApprovalDecision;
+}
+interface UserToolResponseEvent {
+    type: "user.tool_response";
+    threadId: string;
+    toolCallId: string;
+    content: string;
+}
+type TurnInputItem = UserMessage | UserToolApprovalEvent | UserToolResponseEvent;
+type TurnStateRunning = {
+    status: "running";
+};
+/**
+ * Aggregated token metrics on a finished turn (`turn.done.state.metrics`).
+ * Host maps wire snake_case (`total_input_tokens`, …) → camelCase here.
+ */
+interface TurnDoneMetrics {
+    totalInputTokens: number;
+    totalOutputTokens: number;
+    totalTokens: number;
+    totalCacheReadTokens: number;
+    totalCacheWriteTokens: number;
+    totalReasoningTokens: number;
+}
+type TurnStateDone = {
+    status: "done";
+    output?: unknown;
+    requiredActions?: ActionRequiredEvent[];
+    completedAt: string;
+    /** Present when the host reports per-turn token totals. */
+    metrics?: TurnDoneMetrics;
+};
+type TurnStateCancelled = {
+    status: "cancelled";
+    reason: string;
+    completedAt: string;
+};
+type TurnStateError = {
+    status: "error";
+    message: string;
+    completedAt: string;
+};
+type TurnState = TurnStateRunning | TurnStateDone | TurnStateCancelled | TurnStateError;
 interface SaveAgentResult {
     /** Immutable id allocated by the host registry. */
     agentId?: string;
+    /** Version id allocated by the host registry for this save. */
+    versionId?: string;
     /** Timestamp returned when the active mutable session was updated. */
     sessionUpdatedAt?: string;
 }
@@ -316,6 +646,220 @@ interface SandboxCatalogServer<TProvider extends SandboxBase = SandboxBase, TCat
 }
 /** Host-facing selector / compose aliases (trueforge-ui public names). */
 type ModelSelection = ModelSelectorEntry;
+/**
+ * Published agent identity + spec for the agent-detail Overview (read-only).
+ * Host widens `TSpec` (and may extend this DTO) for mounts / config / extras.
+ */
+interface AgentDetail<TSpec extends AgentSpec = AgentSpec> {
+    agentId: string;
+    /** Display name (e.g. "release-notes-writer"). */
+    name: string;
+    /** Published-agent description; not part of the executable agent spec. */
+    description?: string;
+    agentSpec: TSpec;
+}
+/** Stream vs non-stream bodies for one language on the Use In Code tab. */
+interface CodeSnippetSampleCode {
+    stream: string;
+    nonStream: string;
+}
+/**
+ * One language row for Use In Code.
+ * Host maps wire `sample_code` / `non_stream` → camelCase here.
+ */
+interface CodeSnippet<TSample extends CodeSnippetSampleCode = CodeSnippetSampleCode> {
+    /** Sidebar label (e.g. "TypeScript"). */
+    labelName: string;
+    /** Highlighter / tab id (e.g. "typescript"). */
+    language: string;
+    icon?: string;
+    sampleCode: TSample;
+}
+/**
+ * Aggregated session metrics for the sessions list sidebar.
+ * Host maps wire snake_case (`total_turns`, `total_cost_in_usd`, …) → camelCase.
+ */
+interface SessionListMetrics {
+    totalTurns: number;
+    totalCostInUsd?: number;
+    totalDurationMs: number;
+}
+/**
+ * One row in the Agent Sessions list (left pane).
+ *
+ * Binding: `agentName` → named / immutable agent; `agentSpec` → mutable / draft.
+ * Host may send one, both, or neither depending on how the session was created.
+ */
+interface SessionListEntry<TSpec extends AgentSpec = AgentSpec> {
+    id: string;
+    title?: string | null;
+    createdAt: string;
+    updatedAt: string;
+    lastActivityAt: string;
+    metrics: SessionListMetrics;
+    /** Present when bound to a published (immutable) agent. */
+    agentName?: string | null;
+    /** Present when bound to a mutable / draft agent spec. */
+    agentSpec?: TSpec;
+}
+/** Params for `AgentSessionsServer.listSessionEvents` (session event timeline). */
+interface ListSessionEventsParams extends Pick<PageParams, "limit" | "pageToken"> {
+    sessionId: string;
+}
+/**
+ * Optional plug-in for agent-detail UI: Overview, Use In Code, sessions list,
+ * and per-session event timeline. Omit `sessions` on `AgentUIServerPort` when
+ * the host has no agent-detail surface.
+ *
+ * Read-only — create/update/delete stay on `AgentChatServer` / `AgentBuilderServer`.
+ */
+interface AgentSessionsServer<TSpec extends AgentSpec = AgentSpec, TDetail extends AgentDetail<TSpec> = AgentDetail<TSpec>, TSnippet extends CodeSnippet = CodeSnippet, TListEntry extends SessionListEntry<TSpec> = SessionListEntry<TSpec>, TList extends ListSessionsParams = ListSessionsParams> {
+    /** Fetch published agent details by id for the Overview tab. */
+    getAgent(req: {
+        agentId: string;
+    }): Promise<TDetail>;
+    /** Fetch Use In Code snippets for the agent (one row per language). */
+    getCodeSnippets(req: {
+        agentId: string;
+    }): Promise<TSnippet[]>;
+    /**
+     * List sessions visible to the current user. Pass `agentId` to scope to one
+     * agent; `createdByMe: true` for only sessions they created. Use
+     * `startTimestamp` / `endTimestamp` for date filters.
+     */
+    listSessions(req?: TList): Promise<ListResult<TListEntry>>;
+    /**
+     * Fetch the session event timeline (right pane). Paginate with `pageToken`
+     * until exhausted; rebuild turns from `turn.created` / `turn.done` +
+     * nested `TurnEvent`s. Per-turn token metrics live on `turn.done.state.metrics`.
+     */
+    listSessionEvents(req: ListSessionEventsParams): Promise<ListResult<SessionEventItem>>;
+}
+type ScheduleStatus = "active" | "paused";
+type ScheduleRunStatus = "scheduled" | "triggered" | "failed";
+interface Schedule {
+    id: string;
+    name: string;
+    /** Stable agent id (`AgentSelectorEntry.agentId`). */
+    agentId: string;
+    /** Display name; omit when the host only has `agentId`. */
+    agentName?: string;
+    task: string;
+    cron: string;
+    timezone: string;
+    status: ScheduleStatus;
+    lastRunAt: string | null;
+    /** Creator when the host persists one; omit to hide Created-by UI. */
+    createdBySubject?: CreatedBySubject;
+}
+/** Flat schedule-run DTO (ISO-8601 timestamps; host maps from wire Dates). */
+interface ScheduleRun {
+    id: string;
+    scheduleId: string;
+    name: string;
+    scheduledFor: string;
+    status: ScheduleRunStatus;
+    triggeredAt: string | null;
+    triggeredBy: string;
+}
+interface ListSchedulesParams extends Pick<PageParams, "limit" | "pageToken"> {
+    agentId?: string;
+    /** Multi-agent filter; combined with `agentId` when both are set. */
+    agentIds?: string[];
+}
+interface CreateScheduleRequest {
+    agentId: string;
+    name: string;
+    task: string;
+    cron: string;
+    timezone?: string;
+    status?: ScheduleStatus;
+}
+/** `agentId` is not on the base update body; hosts that allow rebinding can extend `TUpdate`. */
+interface UpdateScheduleRequest {
+    id: string;
+    name: string;
+    task: string;
+    cron: string;
+    timezone?: string;
+    status?: ScheduleStatus;
+}
+interface CreateScheduleRunRequest {
+    scheduleId: string;
+}
+interface ScheduleServer<TSchedule extends Schedule = Schedule, TCreate extends CreateScheduleRequest = CreateScheduleRequest, TUpdate extends UpdateScheduleRequest = UpdateScheduleRequest, TRun extends ScheduleRun = ScheduleRun> {
+    listSchedules(req?: ListSchedulesParams): Promise<ListResult<TSchedule>>;
+    getSchedule(req: {
+        id: string;
+    }): Promise<TSchedule>;
+    createSchedule(req: TCreate): Promise<TSchedule>;
+    updateSchedule(req: TUpdate): Promise<TSchedule>;
+    deleteSchedule(req: {
+        id: string;
+    }): Promise<void>;
+    listScheduleRuns(req: {
+        scheduleId: string;
+    }): Promise<TRun[]>;
+    createScheduleRun(req: CreateScheduleRunRequest): Promise<TRun>;
+}
+type PermissionResourceType = "agent" | "schedule" | "session" | "tenant";
+type ResourcePermission = "USE" | "MANAGE" | "DELETE" | "CREATE";
+interface ListPermissionsRequest {
+    resourceType: PermissionResourceType;
+    resourceIds: string[];
+}
+interface ListPermissionsResponse {
+    data: {
+        type: PermissionResourceType;
+        permissions: Record<string, ResourcePermission[]>;
+    };
+}
+type AgentMetricChartType = "line";
+interface AgentMetricChartDefinition {
+    name: string;
+    displayName: string;
+    description: string;
+    chartType: AgentMetricChartType;
+}
+interface AgentMetricMeter {
+    name: string;
+    aggregateValue: number;
+    description: string;
+    unit: string;
+}
+interface AgentMetricPoint {
+    timestamp: string;
+    value: number;
+}
+interface AgentMetricGraphLine<TPoint extends AgentMetricPoint = AgentMetricPoint> {
+    name: string;
+    values: TPoint[];
+}
+interface AgentMetricGraph<TLine extends AgentMetricGraphLine = AgentMetricGraphLine> {
+    name: string;
+    displayName: string;
+    description: string;
+    unit: string;
+    chartType: AgentMetricChartType;
+    graphLines: TLine[];
+}
+interface AgentMetricChartData<TGraph extends AgentMetricGraph = AgentMetricGraph> {
+    step: string;
+    graphs: TGraph[];
+}
+interface AgentMetricRangeRequest {
+    agentId: string;
+    startTimestamp: string;
+    endTimestamp: string;
+}
+interface AgentMetricChartDataRequest extends AgentMetricRangeRequest {
+    chartName: string;
+}
+interface AgentMetricsServer<TChart extends AgentMetricChartDefinition = AgentMetricChartDefinition, TMeter extends AgentMetricMeter = AgentMetricMeter, TChartData extends AgentMetricChartData = AgentMetricChartData, TRangeRequest extends AgentMetricRangeRequest = AgentMetricRangeRequest, TChartDataRequest extends AgentMetricChartDataRequest = AgentMetricChartDataRequest> {
+    getCharts(): Promise<TChart[]>;
+    getMeters(req: TRangeRequest): Promise<TMeter[]>;
+    getChartData(req: TChartDataRequest): Promise<TChartData>;
+}
 
 /**
  * TrueForge HTTP client for the Harness adapter.
@@ -330,11 +874,24 @@ interface CreateTrueForgeClientOptions {
 }
 declare function createTrueForgeClient(options?: CreateTrueForgeClientOptions): TrueForge;
 
-type HarnessSkillMount = TrueForgeApi.Skill;
+/** Catalog attach key may sit on `id`; wire Skill is name-only. See builder getSkills. */
+type HarnessSkillMount = TrueForgeApi.Skill & {
+    id?: string;
+};
 type HarnessMcpServerMount = TrueForgeApi.McpServer;
-interface HarnessAgentSpec extends AgentSpec<TrueForgeApi.Model, HarnessSkillMount, HarnessMcpServerMount, TrueForgeApi.RuntimeConfig>, TrueForgeApi.AgentSpec {
+interface HarnessAgentSpec extends AgentSpec$1<TrueForgeApi.Model, HarnessSkillMount, HarnessMcpServerMount, TrueForgeApi.RuntimeConfig>, Omit<TrueForgeApi.AgentSpec, 'skills'> {
 }
 
+type CreateHarnessAgentMetricsServerOptions = CreateTrueForgeClientOptions & {
+    client?: TrueForge;
+};
+declare function createHarnessAgentMetricsServer(options?: CreateHarnessAgentMetricsServerOptions): AgentMetricsServer$1;
+
+type CreateHarnessAgentSessionsServerOptions = CreateTrueForgeClientOptions & {
+    client?: TrueForge;
+};
+declare function createHarnessAgentSessionsServer(options?: CreateHarnessAgentSessionsServerOptions): AgentSessionsServer$1<HarnessAgentSpec>;
+
 /**
  * AgentBuilderServer callbacks for createTrueFoundryServer.
  * Composer pickers + agent library backed by the Harness agents registry.
@@ -435,7 +992,7 @@ declare function createSandboxProviderCatalog(client: TrueForge): SandboxCatalog
  */
 
 type UiSkill = DefinedSkill;
-declare function toHarnessManifest(req: SkillConfigBase$1): TrueForgeApi.SkillManifest;
+declare function toHarnessManifest(req: SkillConfigBase$1): TrueForgeApi.settings.CreateSkillRequest['manifest'];
 declare function toUiSkill(skill: TrueForgeApi.ConfiguredSkill, catalogNames: ReadonlySet<string>): UiSkill;
 /** Settings skill-catalog port for `createTrueFoundryServer`. Delete omitted (no BE route). */
 declare function createSkillCatalog(client: TrueForge): SkillCatalogServer$1<UiSkill>;
@@ -447,7 +1004,7 @@ declare function createSkillCatalog(client: TrueForge): SkillCatalogServer$1<UiS
  * `nextPageToken`), and `null` normalized to absent. Harness keys MCP mounts by
  * name and returns `null` for optional fields — the maps below bridge both.
  *
- * Skills are name refs on the wire (`Skill`).
+ * Skills are name (+ optional preload) refs on the wire (`Skill`).
  *
  * Session create takes `{ name }` or `{ spec }`; reads carry the
  * `reference`/`inline` discriminator, with reference rows already naming their
@@ -458,10 +1015,17 @@ type CreateHarnessChatServerOptions = CreateTrueForgeClientOptions & {
     /** Injected client — skips creating one from options. */
     client?: TrueForge;
 };
+/** UI session with create-agent intent for resume chrome. */
+type HarnessUiSession = Session<HarnessAgentSpec> & {
+    isCreateAgent: boolean;
+};
+type HarnessCreateSessionRequest = CreateSessionRequest<HarnessAgentSpec> & {
+    metadata?: Record<string, string>;
+};
 /** Drop UI draft `id` before admission; Harness MCP mounts are name-keyed. */
 declare function toHarnessAgentSpec(spec: HarnessAgentSpec): TrueForgeApi.AgentSpec;
 declare function toUiAgentSpec(spec: TrueForgeApi.AgentSpec): HarnessAgentSpec;
-declare function createHarnessChatServer(options?: CreateHarnessChatServerOptions): AgentChatServer<HarnessAgentSpec>;
+declare function createHarnessChatServer(options?: CreateHarnessChatServerOptions): AgentChatServer<HarnessAgentSpec, HarnessUiSession, HarnessCreateSessionRequest>;
 
 /**
  * Configured-resource list helpers for composer pickers and host boot.
@@ -473,13 +1037,28 @@ declare function listConfiguredMcpServers(client: TrueForge): Promise<TrueForgeA
 declare function listSkills(client: TrueForge): Promise<TrueForgeApi.AvailableSkill[]>;
 declare function getCapabilities(client: TrueForge): Promise<TrueForgeApi.CapabilitiesData>;
 
+type CreateHarnessPermissionsServerOptions = CreateTrueForgeClientOptions & {
+    client?: TrueForge;
+};
+declare function createHarnessPermissionsServer(options?: CreateHarnessPermissionsServerOptions): PermissionsServer;
+
+/**
+ * Harness ScheduleServer adapter — maps flat runtime DTOs to SDK wire (manifest + agentName).
+ */
+
+declare function createScheduleServer(options: {
+    client: TrueForge;
+}): ScheduleServer$1;
+
 type CreateTrueForgeAgentUIServerOptions = CreateTrueForgeClientOptions & {
     /** Override the default Harness settings catalogs. */
     catalog?: CatalogServer;
+    /** Optional host-provided resource permissions port. */
+    permissions?: PermissionsServer;
 };
 /**
- * Compose chat + builder + default settings catalogs into an `AgentUIServer`.
+ * Compose chat + builder + agent sessions + default settings catalogs into an `AgentUIServer`.
  */
-declare function createTrueForgeAgentUIServer(options?: CreateTrueForgeAgentUIServerOptions): TrueFoundryServer<HarnessAgentSpec, ModelSelection, _truefoundry_assistant_ui_runtime.SkillSelectorEntry, _truefoundry_assistant_ui_runtime.ConnectorSelectorEntry, _truefoundry_assistant_ui_runtime.AgentSelectorEntry, SaveAgentResult, CatalogServer<ModelCatalogServer<ModelEntry, ModelProviderBase<ModelEntry>, ModelProviderCatalogEntry<ModelEntry>, CreateModelProviderRequest<ModelEntry>, UpdateModelProviderRequest<ModelEntry>>, ConnectorCatalogServer<ToolBase, ConnectorAuth, ConnectorAuthPublic, ConnectorBase<ConnectorAuthPublic>, ConnectorCatalogEntry<ConnectorAuthPublic>, CreateConnectorRequest<ConnectorAuth>, UpdateConnectorRequest<ConnectorAuth>>, SkillCatalogServer<SkillBase, SkillCatalogEntry, CreateSkillRequest>, SandboxCatalogServer<_truefoundry_assistant_ui_runtime.SandboxBase, _truefoundry_assistant_ui_runtime.SandboxCatalogEntry, _truefoundry_assistant_ui_runtime.CreateSandboxRequest, _truefoundry_assistant_ui_runtime.UpdateSandboxRequest, SandboxProviderListEntry<_truefoundry_assistant_ui_runtime.SandboxBase>>>, AgentBuilderCapabilitiesResponse>;
+declare function createTrueForgeAgentUIServer(options?: CreateTrueForgeAgentUIServerOptions): TrueFoundryServer<HarnessAgentSpec, ModelSelection, _truefoundry_assistant_ui_runtime.SkillSelectorEntry, _truefoundry_assistant_ui_runtime.ConnectorSelectorEntry, _truefoundry_assistant_ui_runtime.AgentSelectorEntry, SaveAgentResult, CatalogServer<ModelCatalogServer<ModelEntry, ModelProviderBase<ModelEntry>, ModelProviderCatalogEntry<ModelEntry>, CreateModelProviderRequest<ModelEntry>, UpdateModelProviderRequest<ModelEntry>>, ConnectorCatalogServer<ToolBase, ConnectorAuth, ConnectorAuthPublic, ConnectorBase<ConnectorAuthPublic>, ConnectorCatalogEntry<ConnectorAuthPublic>, CreateConnectorRequest<ConnectorAuth>, UpdateConnectorRequest<ConnectorAuth>>, SkillCatalogServer<SkillBase, SkillCatalogEntry, CreateSkillRequest>, SandboxCatalogServer<_truefoundry_assistant_ui_runtime.SandboxBase, _truefoundry_assistant_ui_runtime.SandboxCatalogEntry, _truefoundry_assistant_ui_runtime.CreateSandboxRequest, _truefoundry_assistant_ui_runtime.UpdateSandboxRequest, SandboxProviderListEntry<_truefoundry_assistant_ui_runtime.SandboxBase>>>, AgentBuilderCapabilitiesResponse, AgentSessionsServer<HarnessAgentSpec, AgentDetail<HarnessAgentSpec>, CodeSnippet<CodeSnippetSampleCode>, SessionListEntry<HarnessAgentSpec>, ListSessionsParams>, AgentMetricsServer<AgentMetricChartDefinition, AgentMetricMeter, AgentMetricChartData<AgentMetricGraph<AgentMetricGraphLine<AgentMetricPoint>>>, AgentMetricRangeRequest, AgentMetricChartDataRequest>, ScheduleServer<Schedule, CreateScheduleRequest, UpdateScheduleRequest, ScheduleRun>, PermissionsServer<ListPermissionsRequest, ListPermissionsResponse>>;
 
-export { type CreateHarnessBuilderServerOptions, type CreateHarnessChatServerOptions, type CreateTrueForgeAgentUIServerOptions, type CreateTrueForgeClientOptions, type HarnessAgentSpec, type HarnessMcpServerMount, type HarnessSkillMount, configFromHarness, createConnectorCatalog, createHarnessBuilderServer, createHarnessChatServer, createModelProviderCatalog, createSandboxProviderCatalog, createSkillCatalog, createTrueForgeAgentUIServer, createTrueForgeClient, filterUiSandboxProviders, getCapabilities, listConfiguredMcpServers, listModels, listSkills, modelProviderLogosByName, toHarnessAgentSpec, toHarnessAuth, toHarnessManifest$2 as toHarnessConnectorManifest, toHarnessModelProvider, toHarnessManifest$1 as toHarnessSandboxManifest, toHarnessManifest as toHarnessSkillManifest, toModelSelection, toUiAgentSpec, toUiCatalogModelProviderEntry, toUiConnector, toUiConnectorFromReadEntry, toUiModelProvider, toUiSandboxProvider, toUiSandboxProviderListEntry, toUiSkill };
+export { type CreateHarnessAgentMetricsServerOptions, type CreateHarnessAgentSessionsServerOptions, type CreateHarnessBuilderServerOptions, type CreateHarnessChatServerOptions, type CreateHarnessPermissionsServerOptions, type CreateTrueForgeAgentUIServerOptions, type CreateTrueForgeClientOptions, type HarnessAgentSpec, type HarnessMcpServerMount, type HarnessSkillMount, configFromHarness, createConnectorCatalog, createHarnessAgentMetricsServer, createHarnessAgentSessionsServer, createHarnessBuilderServer, createHarnessChatServer, createHarnessPermissionsServer, createModelProviderCatalog, createSandboxProviderCatalog, createScheduleServer, createSkillCatalog, createTrueForgeAgentUIServer, createTrueForgeClient, filterUiSandboxProviders, getCapabilities, listConfiguredMcpServers, listModels, listSkills, modelProviderLogosByName, toHarnessAgentSpec, toHarnessAuth, toHarnessManifest$2 as toHarnessConnectorManifest, toHarnessModelProvider, toHarnessManifest$1 as toHarnessSandboxManifest, toHarnessManifest as toHarnessSkillManifest, toModelSelection, toUiAgentSpec, toUiCatalogModelProviderEntry, toUiConnector, toUiConnectorFromReadEntry, toUiModelProvider, toUiSandboxProvider, toUiSandboxProviderListEntry, toUiSkill };