@squidcloud/jira-client 1.0.498 → 1.0.499

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -421,7 +421,7 @@ export interface IntegrationModelSpec {
421
421
  */
422
422
  export type AiChatModelSelection = AiChatModelName | IntegrationModelSpec;
423
423
  /**
424
- * Lets a routing model pick which of several vendor models answers an `ask` request. The routing model
424
+ * Lets a routing model pick which of several vendor models answers an `ask` or `chat` request. The routing model
425
425
  * sees the question, the agent's instructions and a card per candidate (price, tier, reasoning,
426
426
  * context window) and names the one that should answer; that model then serves the request.
427
427
  * @category AI
@@ -433,12 +433,27 @@ export interface AiModelRoutingOptions {
433
433
  routingModel: VendorAiChatModelName;
434
434
  }
435
435
  /**
436
- * The model of an `ask` request: a concrete model, or a set of models a routing model chooses from.
436
+ * The model of an `ask` or `chat` request: a concrete model, or a set of models a routing model chooses from.
437
437
  * @category AI
438
438
  */
439
439
  export type AiAskModelSelection = AiChatModelSelection | AiModelRoutingOptions;
440
440
  /**
441
- * How an `ask` request whose `model` was an {@link AiModelRoutingOptions} was routed.
441
+ * What a `chat` job resolves to once its stream has ended; read it with `squid.jobs().awaitJob(jobId)`.
442
+ * @category AI
443
+ */
444
+ export interface AiChatJobResult {
445
+ /** Set when `model` was an {@link AiModelRoutingOptions}: which model answered and what routing cost. */
446
+ routing?: AiModelRoutingResult;
447
+ }
448
+ /**
449
+ * Chat options as a request carries them: the model may also be a routing choice between several models.
450
+ * @category AI
451
+ */
452
+ export type AiChatRequestOptions = Omit<AllAiAgentChatOptions, 'model'> & {
453
+ model?: AiAskModelSelection;
454
+ };
455
+ /**
456
+ * How a request whose `model` was an {@link AiModelRoutingOptions} was routed.
442
457
  * @category AI
443
458
  */
444
459
  export interface AiModelRoutingResult {
@@ -783,7 +798,7 @@ export type AiVerbosityLevel = 'low' | 'medium' | 'high';
783
798
  * **Example:**
784
799
  * ```typescript
785
800
  * {
786
- * model: 'claude-sonnet-5',
801
+ * model: 'claude-sonnet-5-5',
787
802
  * responseFormat: {
788
803
  * type: 'json_schema',
789
804
  * schema: {
@@ -61,12 +61,12 @@ export declare const GROK_CHAT_MODEL_NAMES: readonly ["grok-4.6", "grok-4-1-fast
61
61
  * Public Anthropic chat model names (active models only).
62
62
  * @category AI
63
63
  */
64
- export declare const ANTHROPIC_CHAT_MODEL_NAMES: readonly ["claude-fable-5", "claude-fable-5-1", "claude-haiku-4-5-20251001", "claude-opus-5-5", "claude-sonnet-5"];
64
+ export declare const ANTHROPIC_CHAT_MODEL_NAMES: readonly ["claude-fable-5", "claude-fable-5-1", "claude-haiku-4-5-20251001", "claude-opus-5-5", "claude-sonnet-5-5"];
65
65
  /**
66
66
  * The supported AI model names.
67
67
  * @category AI
68
68
  */
69
- export declare const VENDOR_AI_CHAT_MODEL_NAMES: readonly ["gpt-5.6-sol", "gpt-5.6-terra", "gpt-5.6-luna", "gpt-6-astra", "gpt-6-luna", "gpt-6.1-sol", "claude-fable-5", "claude-fable-5-1", "claude-haiku-4-5-20251001", "claude-opus-5-5", "claude-sonnet-5", "gemini-3.1-pro", "gemini-3.8-flash", "gemini-3.5-flash-lite", "grok-4.6", "grok-4-1-fast-reasoning", "grok-4-1-fast-non-reasoning"];
69
+ export declare const VENDOR_AI_CHAT_MODEL_NAMES: readonly ["gpt-5.6-sol", "gpt-5.6-terra", "gpt-5.6-luna", "gpt-6-astra", "gpt-6-luna", "gpt-6.1-sol", "claude-fable-5", "claude-fable-5-1", "claude-haiku-4-5-20251001", "claude-opus-5-5", "claude-sonnet-5-5", "gemini-3.1-pro", "gemini-3.8-flash", "gemini-3.5-flash-lite", "grok-4.6", "grok-4-1-fast-reasoning", "grok-4-1-fast-non-reasoning"];
70
70
  /** Checks if the given model name is a global AI chat model name. */
71
71
  export declare function isVendorAiChatModelName(modelName: unknown): modelName is VendorAiChatModelName;
72
72
  /**
@@ -1977,7 +1977,8 @@ export interface BulkIngestionJobStatusCounts {
1977
1977
  * cross it under load. So do `'SOURCE_UNREACHABLE'` (the provider could not fetch the source, which a
1978
1978
  * fresh link can fix) and `'PROVIDER_ACCESS_DENIED'` (the provider refused the credential or its quota is
1979
1979
  * spent, a fault of the environment). `'JOB_FULL'`: the job's request ceiling had no room left for this
1980
- * file, so re-submit it in a fresh job; a file that alone exceeds the ceiling fails this way in every job.
1980
+ * file when it was admitted — before any paid stage ran — so re-submit it in a fresh job; a file that
1981
+ * alone exceeds the ceiling fails this way in every job.
1981
1982
  * @category AI
1982
1983
  */
1983
1984
  export type BulkIngestionFileErrorCode = 'CONTENT_TOO_LARGE' | 'DUPLICATE_CONTENT' | 'ENCRYPTED_DOCUMENT' | 'EXTRACTION_TIMED_OUT' | 'IMAGE_OVER_PROVIDER_LIMIT' | 'JOB_FULL' | 'NO_EMBEDDABLE_CONTENT' | 'PROVIDER_ACCESS_DENIED' | 'SOURCE_OVER_PROVIDER_LIMIT' | 'SOURCE_UNREACHABLE' | 'UNREADABLE_DOCUMENT' | 'UNREADABLE_WORKBOOK' | 'UNSUPPORTED_FILE_TYPE';
@@ -9,6 +9,11 @@ export interface InvokeLangGraphOptions {
9
9
  input?: Record<string, unknown>;
10
10
  /** How long the run may take, in ms, before it stops and fails. At most, and by default, one hour. */
11
11
  timeoutMs?: number;
12
+ /**
13
+ * Context of the run, which every node reads as LangGraph's `runtime.context`. It is not stored, so a resume
14
+ * passes its own.
15
+ */
16
+ context?: Record<string, unknown>;
12
17
  }
13
18
  /**
14
19
  * Options for resuming an interrupted LangGraph thread.
@@ -17,6 +22,8 @@ export interface InvokeLangGraphOptions {
17
22
  export interface ResumeLangGraphOptions {
18
23
  /** How long the resumed run may take, in ms, before it stops and fails. At most, and by default, one hour. */
19
24
  timeoutMs?: number;
25
+ /** Context of the resumed run, which every node reads as LangGraph's `runtime.context`. */
26
+ context?: Record<string, unknown>;
20
27
  }
21
28
  /**
22
29
  * Successful result of a LangGraph invocation.
@@ -1,4 +1,4 @@
1
- import { AiConnectedIntegrationMetadata, AiSessionContext, AllAiAgentChatOptions } from '../public-types/ai-agent.public-types';
1
+ import { AiChatRequestOptions, AiConnectedIntegrationMetadata, AiSessionContext } from '../public-types/ai-agent.public-types';
2
2
  import { AiFunctionId } from '../public-types/backend.public-types';
3
3
  import { AiAgentId, IntegrationId } from '../public-types/communication.public-types';
4
4
  import { AuthWithBearer } from '../public-types/context.public-types';
@@ -44,7 +44,11 @@ export interface AiFunctionCallContextWithIntegration<AiConnectedIntegrationOpti
44
44
  export declare class SecureAiAgentContext {
45
45
  readonly prompt?: string;
46
46
  readonly agentId: AiAgentId;
47
- readonly options?: AllAiAgentChatOptions;
47
+ /**
48
+ * The request's chat options. `model` may be a routing choice the caller asked for: check
49
+ * `'models' in model` before reading it as a concrete model selection.
50
+ */
51
+ readonly options?: AiChatRequestOptions;
48
52
  }
49
53
  /**
50
54
  * Provides context to a knowledge base's `accessControl.scopeResolver` function, which turns the caller
@@ -11,6 +11,10 @@ export declare class SecureLangGraphContext {
11
11
  readonly operation: SecureLangGraphOperation;
12
12
  readonly graphId: string;
13
13
  readonly threadId?: string;
14
+ /** The input of the run (`invoke`). */
14
15
  readonly input?: Record<string, unknown>;
16
+ /** The value the run resumes with (`resume`). */
15
17
  readonly resumePayload?: unknown;
18
+ /** The context the caller passed for the run (`invoke` and `resume`), which nodes read as `runtime.context`. */
19
+ readonly graphContext?: Record<string, unknown>;
16
20
  }
@@ -31,6 +31,11 @@ export declare function cloneShallow<T>(value: T): T;
31
31
  export declare function deepMerge<T extends object, U extends object>(target: T, source: U): T & U;
32
32
  /** Returns true if the `value` is a defined object and is not an array. */
33
33
  export declare function isPlainObject(value: unknown): value is object;
34
+ /**
35
+ * Returns true if the `value` is an object that JSON can hold as it is: a plain object whose values are JSON at any
36
+ * depth, with no `__proto__` key. A `Date` or another class instance is not one.
37
+ */
38
+ export declare function isJsonObject(value: unknown): value is Record<string, unknown>;
34
39
  /** Compares 2 values. 'null' and 'undefined' values are considered equal and are less than any other values. */
35
40
  export declare function compareValues(v1: unknown, v2: unknown): number;
36
41
  /** Returns a new object with all top-level object fields re-mapped using `valueMapperFn`. */
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@squidcloud/jira-client",
3
- "version": "1.0.498",
3
+ "version": "1.0.499",
4
4
  "description": "Squid Jira Client - SDK for interacting with the Jira connector",
5
5
  "main": "dist/index.js",
6
6
  "types": "dist/jira-client/src/index.d.ts",
@@ -23,7 +23,7 @@
23
23
  "license": "ISC",
24
24
  "dependencies": {
25
25
  "assertic": "^1.3.0",
26
- "@squidcloud/client": "^1.0.498"
26
+ "@squidcloud/client": "^1.0.499"
27
27
  },
28
28
  "engines": {
29
29
  "node": ">=20.0.0"