@open-agent-toolkit/cli 0.2.65 → 0.2.67

package/dist/commands/pjm/remote/providers/linear.d.ts

@@ -0,0 +1,182 @@
+import { type OutboundProjection, type OutboundProjectionSafetyResult } from '../../../pjm/remote/outbound-projection-safety.js';
+import { type FieldVerification, type NormalizedRemoteIssue, type ObservationValidation, type ProviderAdapter, type ProviderContext, type SanitizedProviderObservation, type SemanticAction, type SemanticOperation } from '../../../pjm/remote/provider.js';
+export interface LinearIssueReference {
+    host?: string;
+    identifier: string;
+    alias: string;
+}
+export type LinearSemanticField = 'stable-identity' | 'title' | 'description' | 'state' | 'priority' | 'revision' | 'team-context';
+export interface LinearHostCapabilityObservation {
+    provider: 'linear';
+    context: ProviderContext;
+    availability: 'available' | 'unavailable' | 'authorization-required' | 'rate-limited';
+    accountId: string;
+    workspaceId: string;
+    teamId: string;
+    operations: SemanticOperation[];
+    observableFields: LinearSemanticField[];
+    evidenceDigest: string;
+}
+export interface LinearReadPlanInput {
+    context: ProviderContext;
+    hostCapability: LinearHostCapabilityObservation;
+    stableId: string;
+    uuid: string;
+    currentIdentifier: string | null;
+    stepId: string;
+}
+export interface LinearDiscussionReadPlanInput {
+    context: ProviderContext;
+    hostCapability: LinearHostCapabilityObservation;
+    stableId: string;
+    cursor: string | null;
+    limit: number;
+}
+export type LinearMutationField = 'title' | 'description' | 'priority' | 'status' | 'annotation';
+export interface LinearMutationPreviewInput {
+    operation: 'create' | 'update' | 'transition' | 'annotate';
+    context: ProviderContext;
+    hostCapability: LinearHostCapabilityObservation;
+    bindingId: string;
+    stableId?: string;
+    provenance?: {
+        bindingId: string;
+        origin: string;
+    };
+    fieldMask: readonly string[];
+    projection: OutboundProjection;
+    outboundSafety: OutboundProjectionSafetyResult;
+}
+export interface LinearMutationPlanInput extends LinearMutationPreviewInput {
+    approvedPreviewDigest: string;
+}
+export interface LinearMutationPreview {
+    previewDigest: string;
+    executionEvidence: {
+        capabilityEvidenceDigest: string;
+        projectionDigest: string;
+        outboundSafetyResultDigest: string;
+    };
+}
+export type LinearReadClassification = 'current' | 'moved' | 'archived' | 'partial' | 'inaccessible' | 'temporarily-unavailable';
+export interface LinearReadObservationInput {
+    action: SemanticAction;
+    hostCapability: LinearHostCapabilityObservation;
+    observedAt: string;
+    outcome: 'found' | 'not-found' | 'temporary-failure';
+    observation?: SanitizedProviderObservation;
+}
+export interface LinearReadResult {
+    classification: LinearReadClassification;
+    issue: NormalizedRemoteIssue | null;
+    preservePriorEvidence: boolean;
+    reasons: string[];
+}
+export interface LinearDiscussionItemObservation {
+    id: string;
+    body: string;
+    observedAt: string;
+}
+export interface LinearDiscussionReadObservation {
+    provider: 'linear';
+    context: ProviderContext;
+    stableId: string;
+    availability: 'available' | 'rate-limited' | 'permission-denied';
+    capabilityEvidenceDigest: string;
+    requestedCursor: string | null;
+    nextCursor: string | null;
+    items: LinearDiscussionItemObservation[];
+}
+export interface LinearDiscussionReadValidationInput {
+    action: SemanticAction;
+    hostCapability: LinearHostCapabilityObservation;
+    observation: LinearDiscussionReadObservation;
+}
+export interface LinearMutationVerificationInput {
+    action: SemanticAction;
+    attempt: {
+        count: number;
+        outcome: 'accepted' | 'rejected' | 'unknown';
+        capabilityEvidenceDigest: string;
+    };
+    hostCapability: LinearHostCapabilityObservation;
+    readback: SanitizedProviderObservation | null;
+}
+export interface LinearMutationVerificationResult {
+    classification: 'verified' | 'partial' | 'rejected' | 'uncertain';
+    reason: string;
+    fields: FieldVerification[];
+    retryAllowed: false;
+}
+export interface LinearDuplicateSearchPlanInput {
+    context: ProviderContext;
+    hostCapability: LinearHostCapabilityObservation;
+    provenanceToken: string;
+    reservedBindingId: string;
+    historicalIdentifiers: string[];
+    maxResults: number;
+}
+export interface LinearDuplicateCandidate {
+    uuid: string;
+    stableId: string;
+    identifiers: string[];
+    context: ProviderContext;
+    matchedBy: 'provenance' | 'reserved-binding' | 'identifier';
+    matchedProvenanceToken?: string;
+    matchedReservedBindingId?: string;
+    matchedIdentifier?: string;
+    stableIdentityVerified: boolean;
+    contextVerified: boolean;
+}
+export interface LinearDuplicateSearchObservation {
+    provider: 'linear';
+    context: ProviderContext;
+    availability: 'available' | 'unavailable';
+    capabilityEvidenceDigest: string;
+    queryDigest: string;
+    observedAt: string;
+    results: LinearDuplicateCandidate[];
+}
+export interface LinearDuplicateSearchValidationInput {
+    action: SemanticAction;
+    hostCapability: LinearHostCapabilityObservation;
+    observation: LinearDuplicateSearchObservation;
+}
+export interface LinearDuplicateSearchValidationResult {
+    accepted: boolean;
+    classification: 'no-match' | 'one-verified-match' | 'ambiguous' | 'unavailable' | 'invalid';
+    stableId: string | null;
+    reasons: string[];
+}
+/** Absolute UTF-8 bounds for one non-persisted Linear discussion page. */
+export declare const LINEAR_DISCUSSION_LIMITS: {
+    readonly maxItems: 100;
+    readonly maxIdBytes: 256;
+    readonly maxBodyBytes: 16384;
+    readonly maxCursorBytes: 512;
+    readonly maxPageBytes: 65536;
+};
+export declare function parseLinearIssueReference(reference: string): LinearIssueReference | null;
+export declare function normalizeLinearIssueObservation(observation: SanitizedProviderObservation): NormalizedRemoteIssue;
+export declare function validateLinearHostCapability(operation: SemanticOperation, context: ProviderContext, observed: LinearHostCapabilityObservation, requiredFields?: LinearSemanticField[]): ObservationValidation;
+export declare function planLinearRead(input: LinearReadPlanInput): SemanticAction;
+export declare function planLinearDiscussionRead(input: LinearDiscussionReadPlanInput): SemanticAction;
+export declare function previewLinearMutation(input: LinearMutationPreviewInput): LinearMutationPreview;
+export declare function planLinearMutation(input: LinearMutationPlanInput): SemanticAction;
+export declare function classifyLinearReadObservation(input: LinearReadObservationInput): LinearReadResult;
+export declare function validateLinearDiscussionReadObservation(input: LinearDiscussionReadValidationInput): {
+    classification: 'page' | 'rate-limited' | 'permission-denied' | 'invalid';
+    page: {
+        items: Array<LinearDiscussionItemObservation & {
+            contentSuppressed: boolean;
+        }>;
+        nextCursor: string | null;
+    } | null;
+    persistable: false;
+    reasons: string[];
+};
+export declare function verifyLinearMutationObservation(input: LinearMutationVerificationInput): LinearMutationVerificationResult;
+export declare function planLinearDuplicateSearch(input: LinearDuplicateSearchPlanInput): SemanticAction;
+export declare function validateLinearDuplicateSearchObservation(input: LinearDuplicateSearchValidationInput): LinearDuplicateSearchValidationResult;
+export declare const linearAdapter: ProviderAdapter;
+//# sourceMappingURL=linear.d.ts.map

package/dist/commands/pjm/remote/providers/linear.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"linear.d.ts","sourceRoot":"","sources":["../../../../../src/commands/pjm/remote/providers/linear.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,KAAK,kBAAkB,EACvB,KAAK,8BAA8B,EACpC,MAAM,iDAAiD,CAAC;AACzD,OAAO,EAGL,KAAK,iBAAiB,EACtB,KAAK,qBAAqB,EAC1B,KAAK,qBAAqB,EAC1B,KAAK,eAAe,EACpB,KAAK,eAAe,EACpB,KAAK,4BAA4B,EACjC,KAAK,cAAc,EACnB,KAAK,iBAAiB,EACvB,MAAM,+BAA+B,CAAC;AAGvC,MAAM,WAAW,oBAAoB;IACnC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,MAAM,mBAAmB,GAC3B,iBAAiB,GACjB,OAAO,GACP,aAAa,GACb,OAAO,GACP,UAAU,GACV,UAAU,GACV,cAAc,CAAC;AAEnB,MAAM,WAAW,+BAA+B;IAC9C,QAAQ,EAAE,QAAQ,CAAC;IACnB,OAAO,EAAE,eAAe,CAAC;IACzB,YAAY,EACR,WAAW,GACX,aAAa,GACb,wBAAwB,GACxB,cAAc,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,iBAAiB,EAAE,CAAC;IAChC,gBAAgB,EAAE,mBAAmB,EAAE,CAAC;IACxC,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,eAAe,CAAC;IACzB,cAAc,EAAE,+BAA+B,CAAC;IAChD,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,6BAA6B;IAC5C,OAAO,EAAE,eAAe,CAAC;IACzB,cAAc,EAAE,+BAA+B,CAAC;IAChD,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,MAAM,mBAAmB,GAC3B,OAAO,GACP,aAAa,GACb,UAAU,GACV,QAAQ,GACR,YAAY,CAAC;AAEjB,MAAM,WAAW,0BAA0B;IACzC,SAAS,EAAE,QAAQ,GAAG,QAAQ,GAAG,YAAY,GAAG,UAAU,CAAC;IAC3D,OAAO,EAAE,eAAe,CAAC;IACzB,cAAc,EAAE,+BAA+B,CAAC;IAChD,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IACnD,SAAS,EAAE,SAAS,MAAM,EAAE,CAAC;IAC7B,UAAU,EAAE,kBAAkB,CAAC;IAC/B,cAAc,EAAE,8BAA8B,CAAC;CAChD;AAED,MAAM,WAAW,uBAAwB,SAAQ,0BAA0B;IACzE,qBAAqB,EAAE,MAAM,CAAC;CAC/B;AAED,MAAM,WAAW,qBAAqB;IACpC,aAAa,EAAE,MAAM,CAAC;IACtB,iBAAiB,EAAE;QACjB,wBAAwB,EAAE,MAAM,CAAC;QACjC,gBAAgB,EAAE,MAAM,CAAC;QACzB,0BAA0B,EAAE,MAAM,CAAC;KACpC,CAAC;CACH;AAED,MAAM,MAAM,wBAAwB,GAChC,SAAS,GACT,OAAO,GACP,UAAU,GACV,SAAS,GACT,cAAc,GACd,yBAAyB,CAAC;AAE9B,MAAM,WAAW,0BAA0B;IACzC,MAAM,EAAE,cAAc,CAAC;IACvB,cAAc,EAAE,+BAA+B,CAAC;IAChD,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,OAAO,GAAG,WAAW,GAAG,mBAAmB,CAAC;IACrD,WAAW,CAAC,EAAE,4BAA4B,CAAC;CAC5C;AAED,MAAM,WAAW,gBAAgB;IAC/B,cAAc,EAAE,wBAAwB,CAAC;IACzC,KAAK,EAAE,qBAAqB,GAAG,IAAI,CAAC;IACpC,qBAAqB,EAAE,OAAO,CAAC;IAC/B,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,MAAM,WAAW,+BAA+B;IAC9C,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,+BAA+B;IAC9C,QAAQ,EAAE,QAAQ,CAAC;IACnB,OAAO,EAAE,eAAe,CAAC;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,WAAW,GAAG,cAAc,GAAG,mBAAmB,CAAC;IACjE,wBAAwB,EAAE,MAAM,CAAC;IACjC,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,KAAK,EAAE,+BAA+B,EAAE,CAAC;CAC1C;AAED,MAAM,WAAW,mCAAmC;IAClD,MAAM,EAAE,cAAc,CAAC;IACvB,cAAc,EAAE,+BAA+B,CAAC;IAChD,WAAW,EAAE,+BAA+B,CAAC;CAC9C;AAED,MAAM,WAAW,+BAA+B;IAC9C,MAAM,EAAE,cAAc,CAAC;IACvB,OAAO,EAAE;QACP,KAAK,EAAE,MAAM,CAAC;QACd,OAAO,EAAE,UAAU,GAAG,UAAU,GAAG,SAAS,CAAC;QAC7C,wBAAwB,EAAE,MAAM,CAAC;KAClC,CAAC;IACF,cAAc,EAAE,+BAA+B,CAAC;IAChD,QAAQ,EAAE,4BAA4B,GAAG,IAAI,CAAC;CAC/C;AAED,MAAM,WAAW,gCAAgC;IAC/C,cAAc,EAAE,UAAU,GAAG,SAAS,GAAG,UAAU,GAAG,WAAW,CAAC;IAClE,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,iBAAiB,EAAE,CAAC;IAC5B,YAAY,EAAE,KAAK,CAAC;CACrB;AAED,MAAM,WAAW,8BAA8B;IAC7C,OAAO,EAAE,eAAe,CAAC;IACzB,cAAc,EAAE,+BAA+B,CAAC;IAChD,eAAe,EAAE,MAAM,CAAC;IACxB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,qBAAqB,EAAE,MAAM,EAAE,CAAC;IAChC,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,OAAO,EAAE,eAAe,CAAC;IACzB,SAAS,EAAE,YAAY,GAAG,kBAAkB,GAAG,YAAY,CAAC;IAC5D,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,wBAAwB,CAAC,EAAE,MAAM,CAAC;IAClC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,sBAAsB,EAAE,OAAO,CAAC;IAChC,eAAe,EAAE,OAAO,CAAC;CAC1B;AAED,MAAM,WAAW,gCAAgC;IAC/C,QAAQ,EAAE,QAAQ,CAAC;IACnB,OAAO,EAAE,eAAe,CAAC;IACzB,YAAY,EAAE,WAAW,GAAG,aAAa,CAAC;IAC1C,wBAAwB,EAAE,MAAM,CAAC;IACjC,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,wBAAwB,EAAE,CAAC;CACrC;AAED,MAAM,WAAW,oCAAoC;IACnD,MAAM,EAAE,cAAc,CAAC;IACvB,cAAc,EAAE,+BAA+B,CAAC;IAChD,WAAW,EAAE,gCAAgC,CAAC;CAC/C;AAED,MAAM,WAAW,qCAAqC;IACpD,QAAQ,EAAE,OAAO,CAAC;IAClB,cAAc,EACV,UAAU,GACV,oBAAoB,GACpB,WAAW,GACX,aAAa,GACb,SAAS,CAAC;IACd,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AASD,0EAA0E;AAC1E,eAAO,MAAM,wBAAwB;aACnC,QAAQ,EAAE,GAAG;aACb,UAAU,EAAE,GAAG;aACf,YAAY,EAAE,KAAM;aACpB,cAAc,EAAE,GAAG;aACnB,YAAY,EAAE,KAAM;CACZ,CAAC;AAEX,wBAAgB,yBAAyB,CACvC,SAAS,EAAE,MAAM,GAChB,oBAAoB,GAAG,IAAI,CAY7B;AAED,wBAAgB,+BAA+B,CAC7C,WAAW,EAAE,4BAA4B,GACxC,qBAAqB,CAiFvB;AAED,wBAAgB,4BAA4B,CAC1C,SAAS,EAAE,iBAAiB,EAC5B,OAAO,EAAE,eAAe,EACxB,QAAQ,EAAE,+BAA+B,EACzC,cAAc,GAAE,mBAAmB,EAAO,GACzC,qBAAqB,CA6BvB;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,mBAAmB,GAAG,cAAc,CAgEzE;AAED,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,6BAA6B,GACnC,cAAc,CAkDhB;AAED,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,0BAA0B,GAChC,qBAAqB,CAkCvB;AAED,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,uBAAuB,GAC7B,cAAc,CAwDhB;AAED,wBAAgB,6BAA6B,CAC3C,KAAK,EAAE,0BAA0B,GAChC,gBAAgB,CA2ElB;AAED,wBAAgB,uCAAuC,CACrD,KAAK,EAAE,mCAAmC,GACzC;IACD,cAAc,EAAE,MAAM,GAAG,cAAc,GAAG,mBAAmB,GAAG,SAAS,CAAC;IAC1E,IAAI,EAAE;QACJ,KAAK,EAAE,KAAK,CACV,+BAA+B,GAAG;YAAE,iBAAiB,EAAE,OAAO,CAAA;SAAE,CACjE,CAAC;QACF,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;KAC3B,GAAG,IAAI,CAAC;IACT,WAAW,EAAE,KAAK,CAAC;IACnB,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB,CA+FA;AAED,wBAAgB,+BAA+B,CAC7C,KAAK,EAAE,+BAA+B,GACrC,gCAAgC,CAuGlC;AAED,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,8BAA8B,GACpC,cAAc,CAkDhB;AAED,wBAAgB,wCAAwC,CACtD,KAAK,EAAE,oCAAoC,GAC1C,qCAAqC,CAuGvC;AAED,eAAO,MAAM,aAAa,EAAE,eA8N3B,CAAC"}