@undefineds.co/models 0.2.14 → 0.2.16

package/dist/sidecar/sidecar-events.d.ts

@@ -15,6 +15,23 @@ export declare const ToolCallEventV1Schema: z.ZodObject<{
     toolName: z.ZodString;
     risk: z.ZodOptional<z.ZodEnum<["low", "medium", "high"]>>;
     status: z.ZodEnum<["calling", "waiting_approval", "approved", "rejected", "running", "done", "error"]>;
+    approvalOptions: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        optionId: z.ZodString;
+        label: z.ZodString;
+        kind: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
+    }, "strict", z.ZodTypeAny, {
+        label: string;
+        optionId: string;
+        description?: string | undefined;
+        kind?: string | undefined;
+    }, {
+        label: string;
+        optionId: string;
+        description?: string | undefined;
+        kind?: string | undefined;
+    }>, "many">>;
+    expiresAt: z.ZodOptional<z.ZodString>;
     target: z.ZodOptional<z.ZodString>;
     action: z.ZodOptional<z.ZodString>;
     arguments: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
@@ -37,6 +54,13 @@ export declare const ToolCallEventV1Schema: z.ZodObject<{
     target?: string | undefined;
     action?: string | undefined;
     risk?: "low" | "medium" | "high" | undefined;
+    approvalOptions?: {
+        label: string;
+        optionId: string;
+        description?: string | undefined;
+        kind?: string | undefined;
+    }[] | undefined;
+    expiresAt?: string | undefined;
     policyVersion?: string | undefined;
     decisionBy?: string | undefined;
     decisionRole?: "human" | "secretary" | "system" | undefined;
@@ -57,6 +81,13 @@ export declare const ToolCallEventV1Schema: z.ZodObject<{
     target?: string | undefined;
     action?: string | undefined;
     risk?: "low" | "medium" | "high" | undefined;
+    approvalOptions?: {
+        label: string;
+        optionId: string;
+        description?: string | undefined;
+        kind?: string | undefined;
+    }[] | undefined;
+    expiresAt?: string | undefined;
     policyVersion?: string | undefined;
     decisionBy?: string | undefined;
     decisionRole?: "human" | "secretary" | "system" | undefined;
@@ -76,6 +107,23 @@ export declare const ToolCallEventSchema: z.ZodObject<{
     toolName: z.ZodString;
     risk: z.ZodOptional<z.ZodEnum<["low", "medium", "high"]>>;
     status: z.ZodEnum<["calling", "waiting_approval", "approved", "rejected", "running", "done", "error"]>;
+    approvalOptions: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        optionId: z.ZodString;
+        label: z.ZodString;
+        kind: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
+    }, "strict", z.ZodTypeAny, {
+        label: string;
+        optionId: string;
+        description?: string | undefined;
+        kind?: string | undefined;
+    }, {
+        label: string;
+        optionId: string;
+        description?: string | undefined;
+        kind?: string | undefined;
+    }>, "many">>;
+    expiresAt: z.ZodOptional<z.ZodString>;
     target: z.ZodOptional<z.ZodString>;
     action: z.ZodOptional<z.ZodString>;
     arguments: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
@@ -98,6 +146,13 @@ export declare const ToolCallEventSchema: z.ZodObject<{
     target?: string | undefined;
     action?: string | undefined;
     risk?: "low" | "medium" | "high" | undefined;
+    approvalOptions?: {
+        label: string;
+        optionId: string;
+        description?: string | undefined;
+        kind?: string | undefined;
+    }[] | undefined;
+    expiresAt?: string | undefined;
     policyVersion?: string | undefined;
     decisionBy?: string | undefined;
     decisionRole?: "human" | "secretary" | "system" | undefined;
@@ -118,6 +173,13 @@ export declare const ToolCallEventSchema: z.ZodObject<{
     target?: string | undefined;
     action?: string | undefined;
     risk?: "low" | "medium" | "high" | undefined;
+    approvalOptions?: {
+        label: string;
+        optionId: string;
+        description?: string | undefined;
+        kind?: string | undefined;
+    }[] | undefined;
+    expiresAt?: string | undefined;
     policyVersion?: string | undefined;
     decisionBy?: string | undefined;
     decisionRole?: "human" | "secretary" | "system" | undefined;
@@ -346,8 +408,25 @@ export declare const InboxApprovalEventV1Schema: z.ZodObject<{
     policyVersion: z.ZodOptional<z.ZodString>;
     risk: z.ZodEnum<["low", "medium", "high"]>;
     status: z.ZodEnum<["pending", "approved", "rejected", "expired"]>;
+    approvalOptions: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        optionId: z.ZodString;
+        label: z.ZodString;
+        kind: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
+    }, "strict", z.ZodTypeAny, {
+        label: string;
+        optionId: string;
+        description?: string | undefined;
+        kind?: string | undefined;
+    }, {
+        label: string;
+        optionId: string;
+        description?: string | undefined;
+        kind?: string | undefined;
+    }>, "many">>;
     assignedTo: z.ZodOptional<z.ZodString>;
     createdAt: z.ZodString;
+    expiresAt: z.ZodOptional<z.ZodString>;
     resolvedAt: z.ZodOptional<z.ZodString>;
 }, "strict", z.ZodTypeAny, {
     createdAt: string;
@@ -362,6 +441,13 @@ export declare const InboxApprovalEventV1Schema: z.ZodObject<{
     assignedTo?: string | undefined;
     resolvedAt?: string | undefined;
     policy?: string | undefined;
+    approvalOptions?: {
+        label: string;
+        optionId: string;
+        description?: string | undefined;
+        kind?: string | undefined;
+    }[] | undefined;
+    expiresAt?: string | undefined;
     policyVersion?: string | undefined;
     version?: 1 | undefined;
 }, {
@@ -377,6 +463,13 @@ export declare const InboxApprovalEventV1Schema: z.ZodObject<{
     assignedTo?: string | undefined;
     resolvedAt?: string | undefined;
     policy?: string | undefined;
+    approvalOptions?: {
+        label: string;
+        optionId: string;
+        description?: string | undefined;
+        kind?: string | undefined;
+    }[] | undefined;
+    expiresAt?: string | undefined;
     policyVersion?: string | undefined;
     version?: 1 | undefined;
 }>;
@@ -392,8 +485,25 @@ export declare const InboxApprovalEventSchema: z.ZodObject<{
     policyVersion: z.ZodOptional<z.ZodString>;
     risk: z.ZodEnum<["low", "medium", "high"]>;
     status: z.ZodEnum<["pending", "approved", "rejected", "expired"]>;
+    approvalOptions: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        optionId: z.ZodString;
+        label: z.ZodString;
+        kind: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
+    }, "strict", z.ZodTypeAny, {
+        label: string;
+        optionId: string;
+        description?: string | undefined;
+        kind?: string | undefined;
+    }, {
+        label: string;
+        optionId: string;
+        description?: string | undefined;
+        kind?: string | undefined;
+    }>, "many">>;
     assignedTo: z.ZodOptional<z.ZodString>;
     createdAt: z.ZodString;
+    expiresAt: z.ZodOptional<z.ZodString>;
     resolvedAt: z.ZodOptional<z.ZodString>;
 }, "strict", z.ZodTypeAny, {
     createdAt: string;
@@ -408,6 +518,13 @@ export declare const InboxApprovalEventSchema: z.ZodObject<{
     assignedTo?: string | undefined;
     resolvedAt?: string | undefined;
     policy?: string | undefined;
+    approvalOptions?: {
+        label: string;
+        optionId: string;
+        description?: string | undefined;
+        kind?: string | undefined;
+    }[] | undefined;
+    expiresAt?: string | undefined;
     policyVersion?: string | undefined;
     version?: 1 | undefined;
 }, {
@@ -423,6 +540,13 @@ export declare const InboxApprovalEventSchema: z.ZodObject<{
     assignedTo?: string | undefined;
     resolvedAt?: string | undefined;
     policy?: string | undefined;
+    approvalOptions?: {
+        label: string;
+        optionId: string;
+        description?: string | undefined;
+        kind?: string | undefined;
+    }[] | undefined;
+    expiresAt?: string | undefined;
     policyVersion?: string | undefined;
     version?: 1 | undefined;
 }>;
@@ -435,6 +559,23 @@ export declare const SidecarEventSchema: z.ZodUnion<[z.ZodObject<{
     toolName: z.ZodString;
     risk: z.ZodOptional<z.ZodEnum<["low", "medium", "high"]>>;
     status: z.ZodEnum<["calling", "waiting_approval", "approved", "rejected", "running", "done", "error"]>;
+    approvalOptions: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        optionId: z.ZodString;
+        label: z.ZodString;
+        kind: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
+    }, "strict", z.ZodTypeAny, {
+        label: string;
+        optionId: string;
+        description?: string | undefined;
+        kind?: string | undefined;
+    }, {
+        label: string;
+        optionId: string;
+        description?: string | undefined;
+        kind?: string | undefined;
+    }>, "many">>;
+    expiresAt: z.ZodOptional<z.ZodString>;
     target: z.ZodOptional<z.ZodString>;
     action: z.ZodOptional<z.ZodString>;
     arguments: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
@@ -457,6 +598,13 @@ export declare const SidecarEventSchema: z.ZodUnion<[z.ZodObject<{
     target?: string | undefined;
     action?: string | undefined;
     risk?: "low" | "medium" | "high" | undefined;
+    approvalOptions?: {
+        label: string;
+        optionId: string;
+        description?: string | undefined;
+        kind?: string | undefined;
+    }[] | undefined;
+    expiresAt?: string | undefined;
     policyVersion?: string | undefined;
     decisionBy?: string | undefined;
     decisionRole?: "human" | "secretary" | "system" | undefined;
@@ -477,6 +625,13 @@ export declare const SidecarEventSchema: z.ZodUnion<[z.ZodObject<{
     target?: string | undefined;
     action?: string | undefined;
     risk?: "low" | "medium" | "high" | undefined;
+    approvalOptions?: {
+        label: string;
+        optionId: string;
+        description?: string | undefined;
+        kind?: string | undefined;
+    }[] | undefined;
+    expiresAt?: string | undefined;
     policyVersion?: string | undefined;
     decisionBy?: string | undefined;
     decisionRole?: "human" | "secretary" | "system" | undefined;
@@ -594,8 +749,25 @@ export declare const SidecarEventSchema: z.ZodUnion<[z.ZodObject<{
     policyVersion: z.ZodOptional<z.ZodString>;
     risk: z.ZodEnum<["low", "medium", "high"]>;
     status: z.ZodEnum<["pending", "approved", "rejected", "expired"]>;
+    approvalOptions: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        optionId: z.ZodString;
+        label: z.ZodString;
+        kind: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
+    }, "strict", z.ZodTypeAny, {
+        label: string;
+        optionId: string;
+        description?: string | undefined;
+        kind?: string | undefined;
+    }, {
+        label: string;
+        optionId: string;
+        description?: string | undefined;
+        kind?: string | undefined;
+    }>, "many">>;
     assignedTo: z.ZodOptional<z.ZodString>;
     createdAt: z.ZodString;
+    expiresAt: z.ZodOptional<z.ZodString>;
     resolvedAt: z.ZodOptional<z.ZodString>;
 }, "strict", z.ZodTypeAny, {
     createdAt: string;
@@ -610,6 +782,13 @@ export declare const SidecarEventSchema: z.ZodUnion<[z.ZodObject<{
     assignedTo?: string | undefined;
     resolvedAt?: string | undefined;
     policy?: string | undefined;
+    approvalOptions?: {
+        label: string;
+        optionId: string;
+        description?: string | undefined;
+        kind?: string | undefined;
+    }[] | undefined;
+    expiresAt?: string | undefined;
     policyVersion?: string | undefined;
     version?: 1 | undefined;
 }, {
@@ -625,6 +804,13 @@ export declare const SidecarEventSchema: z.ZodUnion<[z.ZodObject<{
     assignedTo?: string | undefined;
     resolvedAt?: string | undefined;
     policy?: string | undefined;
+    approvalOptions?: {
+        label: string;
+        optionId: string;
+        description?: string | undefined;
+        kind?: string | undefined;
+    }[] | undefined;
+    expiresAt?: string | undefined;
     policyVersion?: string | undefined;
     version?: 1 | undefined;
 }>]>;

package/dist/sidecar/sidecar-events.js

@@ -11,6 +11,12 @@ export const ToolCallStatusSchema = z.enum([
     'error',
 ]);
 const IsoDatetimeSchema = z.string().datetime();
+const ApprovalOptionSchema = z.object({
+    optionId: z.string(),
+    label: z.string(),
+    kind: z.string().optional(),
+    description: z.string().optional(),
+}).strict();
 // --------------------------------------------
 // tool.call
 // --------------------------------------------
@@ -23,6 +29,8 @@ export const ToolCallEventV1Schema = z
     toolName: z.string(),
     risk: RiskLevelSchema.optional(),
     status: ToolCallStatusSchema,
+    approvalOptions: z.array(ApprovalOptionSchema).optional(),
+    expiresAt: IsoDatetimeSchema.optional(),
     // CP0 Pod-only scope projection
     target: z.string().optional(),
     action: z.string().optional(),
@@ -113,8 +121,10 @@ export const InboxApprovalEventV1Schema = z
     policyVersion: z.string().optional(),
     risk: RiskLevelSchema,
     status: InboxApprovalStatusSchema,
+    approvalOptions: z.array(ApprovalOptionSchema).optional(),
     assignedTo: z.string().optional(),
     createdAt: IsoDatetimeSchema,
+    expiresAt: IsoDatetimeSchema.optional(),
     resolvedAt: IsoDatetimeSchema.optional(),
 })
     .strict();

package/dist/vocab/sidecar.vocab.d.ts

@@ -11,8 +11,11 @@ export declare const ApprovalVocab: {
     readonly decisionRole: string;
     readonly onBehalfOf: string;
     readonly reason: string;
+    readonly context: string;
+    readonly approvalOptions: string;
     readonly policyVersion: string;
     readonly createdAt: string;
+    readonly expiresAt: string;
     readonly resolvedAt: string;
 };
 export declare const AuditVocab: {
@@ -32,8 +35,22 @@ export declare const AuditVocab: {
 export declare const GrantVocab: {
     readonly target: string;
     readonly action: string;
+    readonly title: string;
+    readonly summary: string;
+    readonly body: string;
+    readonly schema: string;
+    readonly pageKind: string;
+    readonly wikiStatus: string;
+    readonly tags: string;
+    readonly source: string;
+    readonly sourceHash: string;
+    readonly compiledAt: string;
+    readonly compiledFrom: string;
+    readonly related: string;
     readonly effect: string;
     readonly riskCeiling: string;
+    readonly policy: string;
+    readonly context: string;
     readonly decisionBy: string;
     readonly decisionRole: string;
     readonly onBehalfOf: string;

package/dist/vocab/sidecar.vocab.js

@@ -12,8 +12,11 @@ export const ApprovalVocab = {
     decisionRole: UDFS.decisionRole,
     onBehalfOf: UDFS.onBehalfOf,
     reason: UDFS.reason,
+    context: UDFS.context,
+    approvalOptions: UDFS.approvalOptions,
     policyVersion: UDFS.policyVersion,
     createdAt: DCTerms.created,
+    expiresAt: UDFS.expiresAt,
     resolvedAt: UDFS.resolvedAt,
 };
 export const AuditVocab = {
@@ -33,8 +36,22 @@ export const AuditVocab = {
 export const GrantVocab = {
     target: ODRL.target,
     action: ODRL.action,
+    title: DCTerms.title,
+    summary: UDFS.summary,
+    body: UDFS.body,
+    schema: DCTerms.conformsTo,
+    pageKind: UDFS.pageKind,
+    wikiStatus: UDFS.status,
+    tags: UDFS.tags,
+    source: UDFS.source,
+    sourceHash: UDFS.sourceHash,
+    compiledAt: UDFS.compiledAt,
+    compiledFrom: UDFS.compiledFrom,
+    related: UDFS.related,
     effect: UDFS.effect,
     riskCeiling: UDFS.riskCeiling,
+    policy: UDFS.policy,
+    context: UDFS.context,
     decisionBy: UDFS.decisionBy,
     decisionRole: UDFS.decisionRole,
     onBehalfOf: UDFS.onBehalfOf,

package/dist/watch/index.d.ts

@@ -54,9 +54,20 @@ export interface WatchSessionRecord {
 export type WatchApprovalRequestKind = 'command-approval' | 'file-change-approval' | 'permissions-approval' | 'codex-approval';
 export type WatchInteractionRequestKind = WatchApprovalRequestKind | 'user-input';
 export type WatchApprovalDecision = 'accept' | 'accept_for_session' | 'decline' | 'cancel';
+export type WatchSecretaryApprovalDecision = 'accept' | 'decline' | 'cancel';
+export type WatchApprovalOptionKind = 'allow_once' | 'allow_always' | 'reject_once' | 'reject_always' | (string & {});
+export interface WatchApprovalOption {
+    optionId: string;
+    label: string;
+    kind?: WatchApprovalOptionKind;
+    description?: string;
+}
 interface WatchInteractionRequestBase {
     kind: WatchInteractionRequestKind;
     message: string;
+    approvalOptions?: WatchApprovalOption[];
+    timeoutMs?: number;
+    expiresAt?: string;
     raw?: unknown;
 }
 export interface WatchCommandApprovalRequest extends WatchInteractionRequestBase {
@@ -95,6 +106,38 @@ export interface WatchUserInputAnswerRecord {
     answers: string[];
 }
 export type WatchUserInputAnswers = Record<string, WatchUserInputAnswerRecord>;
+export type WatchSecretaryRecommendationSource = 'model' | 'fallback';
+export interface WatchSecretaryRecommendationBase {
+    kind: WatchInteractionRequestKind;
+    canAutoDecide: boolean;
+    confidence?: number;
+    reason?: string;
+    reactionWindowMs?: number;
+    source?: WatchSecretaryRecommendationSource;
+}
+export interface WatchSecretaryApprovalRecommendation extends WatchSecretaryRecommendationBase {
+    kind: WatchApprovalRequestKind;
+    decision?: WatchSecretaryApprovalDecision;
+}
+export interface WatchSecretaryUserInputRecommendation extends WatchSecretaryRecommendationBase {
+    kind: 'user-input';
+    answers?: WatchUserInputAnswers;
+}
+export type WatchSecretaryRecommendation = WatchSecretaryApprovalRecommendation | WatchSecretaryUserInputRecommendation;
+export interface WatchGrantCoverageDecision {
+    covers: boolean;
+    confidence?: number;
+    reason?: string;
+    source?: WatchSecretaryRecommendationSource;
+}
+export interface ParseWatchSecretaryRecommendationOptions {
+    mode: WatchMode;
+    request: WatchInteractionRequest;
+    defaultReactionWindowMs?: number;
+}
+export declare const DEFAULT_WATCH_SECRETARY_REACTION_WINDOW_MS = 5000;
+export declare const MIN_WATCH_SECRETARY_REACTION_WINDOW_MS = 5000;
+export declare const MAX_WATCH_SECRETARY_REACTION_WINDOW_MS = 60000;
 export interface WatchToolCallEvent {
     type: 'tool.call';
     name: string;
@@ -152,8 +195,10 @@ export interface WatchThreadMetadata extends Record<string, unknown> {
     backendSessionId?: string;
 }
 export type WatchTranscriptMessageRole = 'user' | 'assistant' | 'system';
+export type WatchTranscriptMessageSource = 'user' | 'primary-agent' | 'secretary' | 'tool' | 'system';
 export interface WatchTranscriptMessage {
     role: WatchTranscriptMessageRole;
+    source: WatchTranscriptMessageSource;
     content: string;
     createdAt: string;
 }
@@ -172,6 +217,7 @@ export declare const WATCH_SESSION_FILE_NAME = "session.json";
 export declare const WATCH_EVENTS_FILE_NAME = "events.jsonl";
 export declare function normalizeWatchUserInputQuestion(value: unknown, fallbackId?: string): WatchUserInputQuestion | null;
 export declare function resolveWatchQuestionAnswer(question: WatchUserInputQuestion, answer: string): string[];
+export declare function normalizeWatchApprovalOptions(value: unknown): WatchApprovalOption[];
 export declare function createWatchSessionId(options?: CreateWatchSessionIdOptions): string;
 export declare function normalizeWatchCredentialSource(source?: WatchCredentialSource | null): WatchCredentialSource;
 export declare function shouldAttemptCloudCredentialProbe(requestedSource: WatchCredentialSource, localAuthStatus: WatchAuthStatus): boolean;
@@ -186,6 +232,15 @@ export declare function resolveWatchAutoApprovalDecision(input: {
     mode: WatchMode;
     request: WatchApprovalRequest;
 }): WatchApprovalDecision | null;
+export declare function createFallbackWatchSecretaryRecommendation(input: {
+    mode: WatchMode;
+    request: WatchInteractionRequest;
+}): WatchSecretaryRecommendation | null;
+export declare function parseWatchSecretaryRecommendation(text: string, options: ParseWatchSecretaryRecommendationOptions): WatchSecretaryRecommendation | null;
+export declare function watchApprovalDecisionLabel(decision: WatchApprovalDecision): string;
+export declare function watchUserInputAnswersSummary(answers: WatchUserInputAnswers): string;
+export declare function parseWatchGrantCoverageDecision(text: string): WatchGrantCoverageDecision | null;
+export declare function computeWatchSecretaryReactionWindowMs(confidence: number | undefined, fallback?: number): number;
 export declare function getWatchAuthLoginCommand(backend: WatchBackend): string | null;
 export declare function formatWatchBackendAuthMessage(backend: WatchBackend, detail?: string): string;
 export declare function looksLikeWatchAuthFailureText(text: string): boolean;