@kensio/yulin 1.19.4 → 1.20.0

package/dist/service/bedrock/command/sim-bedrock-command-group.js

@@ -0,0 +1,50 @@
+import { SimBedrockValidationException } from "../error/sim-bedrock.error.js";
+import { simBedrockModelArn } from "../model/sim-bedrock-model-arn.js";
+/**
+ * The action every model invocation authorizes against.
+ *
+ * Real Bedrock authorizes `Converse` with `bedrock:InvokeModel` too. There is
+ * no `bedrock:Converse` action to grant.
+ */
+export const simBedrockInvokeAction = "bedrock:InvokeModel";
+/**
+ * What both simulated Bedrock invocation handlers are built over.
+ *
+ * Each one names a model, authorizes against it and answers from the declared
+ * responses, so all three come from here and each handler is left with the
+ * shape of its own request and response.
+ */
+export class SimBedrockCommandGroup {
+    responses;
+    authorizer;
+    accountRegionScope;
+    constructor(properties) {
+        this.responses = properties.responses;
+        this.authorizer = properties.authorizer;
+        this.accountRegionScope = properties.accountRegionScope;
+    }
+    /**
+     * Read the model a request names.
+     *
+     * The model id is not resolved against anything. Bedrock offers no
+     * enumerable table of model ids to resolve one against, and a model this
+     * simulation refused to recognise would be a model Yulin decided did not
+     * exist.
+     */
+    requireModelId(modelId, operation) {
+        if (modelId === undefined || modelId.length === 0) {
+            throw new SimBedrockValidationException(`${operation} needs a modelId naming the model to invoke`);
+        }
+        return modelId;
+    }
+    /**
+     * Authorize the caller to invoke one model.
+     *
+     * This happens after the request has been checked, so a malformed request
+     * fails the same way whatever the caller is allowed to do.
+     */
+    authorizeModel(modelId, options) {
+        this.authorizer.authorize(simBedrockInvokeAction, simBedrockModelArn(this.accountRegionScope, modelId), options);
+    }
+}
+//# sourceMappingURL=sim-bedrock-command-group.js.map

package/dist/service/bedrock/command/sim-bedrock-command-group.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-bedrock-command-group.js","sourceRoot":"","sources":["../../../../src/service/bedrock/command/sim-bedrock-command-group.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,6BAA6B,EAAE,MAAM,+BAA+B,CAAC;AAC9E,OAAO,EAAE,kBAAkB,EAAE,MAAM,mCAAmC,CAAC;AAKvE;;;;;GAKG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,qBAAqB,CAAC;AAQ5D;;;;;;GAMG;AACH,MAAM,OAAgB,sBAAsB;IACvB,SAAS,CAAsB;IACjC,UAAU,CAAuB;IACjC,kBAAkB,CAA2B;IAE9D,YAAY,UAA4C;QACtD,IAAI,CAAC,SAAS,GAAG,UAAU,CAAC,SAAS,CAAC;QACtC,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC,UAAU,CAAC;QACxC,IAAI,CAAC,kBAAkB,GAAG,UAAU,CAAC,kBAAkB,CAAC;IAC1D,CAAC;IAED;;;;;;;OAOG;IACO,cAAc,CACtB,OAA2B,EAC3B,SAAiB;QAEjB,IAAI,OAAO,KAAK,SAAS,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAClD,MAAM,IAAI,6BAA6B,CACrC,GAAG,SAAS,6CAA6C,CAC1D,CAAC;QACJ,CAAC;QAED,OAAO,OAAO,CAAC;IACjB,CAAC;IAED;;;;;OAKG;IACO,cAAc,CACtB,OAAe,EACf,OAA6C;QAE7C,IAAI,CAAC,UAAU,CAAC,SAAS,CACvB,sBAAsB,EACtB,kBAAkB,CAAC,IAAI,CAAC,kBAAkB,EAAE,OAAO,CAAC,EACpD,OAAO,CACR,CAAC;IACJ,CAAC;CACF"}

package/dist/service/bedrock/command/sim-bedrock-request-options.d.ts

@@ -0,0 +1,9 @@
+import type { SimAwsCaller } from "../../aws/caller/sim-aws-caller.js";
+/**
+ * What a caller can say about itself when it reaches simulated Bedrock
+ * directly rather than through an intercepted SDK client.
+ */
+export interface SimBedrockRequestOptions {
+    readonly caller?: SimAwsCaller;
+}
+//# sourceMappingURL=sim-bedrock-request-options.d.ts.map

package/dist/service/bedrock/command/sim-bedrock-request-options.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-bedrock-request-options.d.ts","sourceRoot":"","sources":["../../../../src/service/bedrock/command/sim-bedrock-request-options.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oCAAoC,CAAC;AAEvE;;;GAGG;AACH,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,MAAM,CAAC,EAAE,YAAY,CAAC;CAChC"}

package/dist/service/bedrock/command/sim-bedrock-request-options.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=sim-bedrock-request-options.js.map

package/dist/service/bedrock/command/sim-bedrock-request-options.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-bedrock-request-options.js","sourceRoot":"","sources":["../../../../src/service/bedrock/command/sim-bedrock-request-options.ts"],"names":[],"mappings":""}

package/dist/service/bedrock/command/sim-bedrock-unsimulated-input.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Refuses the request inputs this simulation does not model.
+ *
+ * The refusal works from the small set of options each command accepts rather
+ * than from a list of everything Bedrock offers, so an option nobody thought
+ * about is refused rather than dropped. Dropping is the failure mode worth
+ * avoiding here: a `Converse` naming a `guardrailConfig` that blocks a prompt
+ * would be answered with the declared response, which is the one answer that
+ * looks right and is not.
+ */
+export declare class SimBedrockUnsimulatedInput {
+    private readonly operation;
+    constructor(operation: string);
+    /**
+     * Refuse every supplied input that is not one of the accepted options.
+     */
+    refuseUnaccepted(input: object, accepted: readonly string[]): void;
+}
+//# sourceMappingURL=sim-bedrock-unsimulated-input.d.ts.map

package/dist/service/bedrock/command/sim-bedrock-unsimulated-input.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-bedrock-unsimulated-input.d.ts","sourceRoot":"","sources":["../../../../src/service/bedrock/command/sim-bedrock-unsimulated-input.ts"],"names":[],"mappings":"AAEA;;;;;;;;;GASG;AACH,qBAAa,0BAA0B;IACrC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IAEnC,YAAY,SAAS,EAAE,MAAM,EAE5B;IAED;;OAEG;IACH,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,MAAM,EAAE,GAAG,IAAI,CAWjE;CACF"}

package/dist/service/bedrock/command/sim-bedrock-unsimulated-input.js

@@ -0,0 +1,30 @@
+import { SimBedrockUnsimulatedInputException } from "../error/sim-bedrock.error.js";
+/**
+ * Refuses the request inputs this simulation does not model.
+ *
+ * The refusal works from the small set of options each command accepts rather
+ * than from a list of everything Bedrock offers, so an option nobody thought
+ * about is refused rather than dropped. Dropping is the failure mode worth
+ * avoiding here: a `Converse` naming a `guardrailConfig` that blocks a prompt
+ * would be answered with the declared response, which is the one answer that
+ * looks right and is not.
+ */
+export class SimBedrockUnsimulatedInput {
+    operation;
+    constructor(operation) {
+        this.operation = operation;
+    }
+    /**
+     * Refuse every supplied input that is not one of the accepted options.
+     */
+    refuseUnaccepted(input, accepted) {
+        for (const [option, value] of Object.entries(input)) {
+            if (value === undefined || accepted.includes(option)) {
+                continue;
+            }
+            throw new SimBedrockUnsimulatedInputException(`${this.operation} ${option} is not simulated: it would be ignored ` +
+                `here and applied on real AWS`);
+        }
+    }
+}
+//# sourceMappingURL=sim-bedrock-unsimulated-input.js.map

package/dist/service/bedrock/command/sim-bedrock-unsimulated-input.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-bedrock-unsimulated-input.js","sourceRoot":"","sources":["../../../../src/service/bedrock/command/sim-bedrock-unsimulated-input.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mCAAmC,EAAE,MAAM,+BAA+B,CAAC;AAEpF;;;;;;;;;GASG;AACH,MAAM,OAAO,0BAA0B;IACpB,SAAS,CAAS;IAEnC,YAAY,SAAiB;QAC3B,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;IAC7B,CAAC;IAED;;OAEG;IACH,gBAAgB,CAAC,KAAa,EAAE,QAA2B;QACzD,KAAK,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YACpD,IAAI,KAAK,KAAK,SAAS,IAAI,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;gBACrD,SAAS;YACX,CAAC;YAED,MAAM,IAAI,mCAAmC,CAC3C,GAAG,IAAI,CAAC,SAAS,IAAI,MAAM,yCAAyC;gBAClE,8BAA8B,CACjC,CAAC;QACJ,CAAC;IACH,CAAC;CACF"}

package/dist/service/bedrock/error/sim-bedrock.error.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Minimal metadata shape for simulated Bedrock errors.
+ */
+export interface SimBedrockErrorMetadata {
+    readonly httpStatusCode?: number;
+}
+/**
+ * Base class for simulated Bedrock errors.
+ */
+export declare class SimBedrockError extends Error {
+    readonly $metadata: SimBedrockErrorMetadata;
+    constructor(message: string, $metadata?: SimBedrockErrorMetadata);
+}
+/**
+ * Simulated Bedrock ValidationException error.
+ *
+ * This is the failure the request input produces on its own: a missing model
+ * id, a conversation with no messages, or a value outside the set the API
+ * accepts.
+ */
+export declare class SimBedrockValidationException extends SimBedrockError {
+    readonly name = "ValidationException";
+    constructor(message: string);
+}
+/**
+ * Simulated Bedrock AccessDeniedException error.
+ *
+ * A caller simulated IAM denies is reported in Bedrock's own terms rather than
+ * through the shared IAM error, because that is the error name a real Bedrock
+ * caller has to handle. Real Bedrock answers it with a 403.
+ */
+export declare class SimBedrockAccessDeniedException extends SimBedrockError {
+    readonly name = "AccessDeniedException";
+    constructor(message: string);
+}
+/**
+ * Simulated Bedrock error for a request input this simulation does not model.
+ *
+ * This is not an error real Bedrock has, and it is reported under the name
+ * real Bedrock refuses bad input with. The input is refused rather than
+ * ignored, because an ignored input looks applied to the request that sent it
+ * and unapplied to everything else. A `guardrailConfig` naming a guardrail
+ * that blocks a prompt is the case worth refusing: the response would come
+ * back whole here and come back blocked on AWS.
+ */
+export declare class SimBedrockUnsimulatedInputException extends SimBedrockError {
+    readonly name = "ValidationException";
+    constructor(message: string);
+}
+/**
+ * Simulated Bedrock error for a response declared against this simulation that
+ * it cannot answer with.
+ *
+ * This is a simulator configuration error rather than an AWS one. A content
+ * block naming two kinds of content at once is refused where the declaration
+ * was written. A declaration carrying nothing the operation asking for it can
+ * use is refused where the call is made, since which operation reaches a rule
+ * is only known then.
+ */
+export declare class SimBedrockDeclarationError extends SimBedrockError {
+    readonly name = "SimBedrockDeclarationError";
+}
+//# sourceMappingURL=sim-bedrock.error.d.ts.map

package/dist/service/bedrock/error/sim-bedrock.error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-bedrock.error.d.ts","sourceRoot":"","sources":["../../../../src/service/bedrock/error/sim-bedrock.error.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;CAClC;AAED;;GAEG;AACH,qBAAa,eAAgB,SAAQ,KAAK;aAGtB,SAAS,EAAE,uBAAuB;IAFpD,YACE,OAAO,EAAE,MAAM,EACC,SAAS,GAAE,uBAA4B,EAGxD;CACF;AAED;;;;;;GAMG;AACH,qBAAa,6BAA8B,SAAQ,eAAe;IAChE,SAAyB,IAAI,yBAAyB;IAEtD,YAAY,OAAO,EAAE,MAAM,EAE1B;CACF;AAED;;;;;;GAMG;AACH,qBAAa,+BAAgC,SAAQ,eAAe;IAClE,SAAyB,IAAI,2BAA2B;IAExD,YAAY,OAAO,EAAE,MAAM,EAE1B;CACF;AAED;;;;;;;;;GASG;AACH,qBAAa,mCAAoC,SAAQ,eAAe;IACtE,SAAyB,IAAI,yBAAyB;IAEtD,YAAY,OAAO,EAAE,MAAM,EAE1B;CACF;AAED;;;;;;;;;GASG;AACH,qBAAa,0BAA2B,SAAQ,eAAe;IAC7D,SAAyB,IAAI,gCAAgC;CAC9D"}

package/dist/service/bedrock/error/sim-bedrock.error.js

@@ -0,0 +1,66 @@
+/**
+ * Base class for simulated Bedrock errors.
+ */
+export class SimBedrockError extends Error {
+    $metadata;
+    constructor(message, $metadata = {}) {
+        super(message);
+        this.$metadata = $metadata;
+    }
+}
+/**
+ * Simulated Bedrock ValidationException error.
+ *
+ * This is the failure the request input produces on its own: a missing model
+ * id, a conversation with no messages, or a value outside the set the API
+ * accepts.
+ */
+export class SimBedrockValidationException extends SimBedrockError {
+    name = "ValidationException";
+    constructor(message) {
+        super(message, { httpStatusCode: 400 });
+    }
+}
+/**
+ * Simulated Bedrock AccessDeniedException error.
+ *
+ * A caller simulated IAM denies is reported in Bedrock's own terms rather than
+ * through the shared IAM error, because that is the error name a real Bedrock
+ * caller has to handle. Real Bedrock answers it with a 403.
+ */
+export class SimBedrockAccessDeniedException extends SimBedrockError {
+    name = "AccessDeniedException";
+    constructor(message) {
+        super(message, { httpStatusCode: 403 });
+    }
+}
+/**
+ * Simulated Bedrock error for a request input this simulation does not model.
+ *
+ * This is not an error real Bedrock has, and it is reported under the name
+ * real Bedrock refuses bad input with. The input is refused rather than
+ * ignored, because an ignored input looks applied to the request that sent it
+ * and unapplied to everything else. A `guardrailConfig` naming a guardrail
+ * that blocks a prompt is the case worth refusing: the response would come
+ * back whole here and come back blocked on AWS.
+ */
+export class SimBedrockUnsimulatedInputException extends SimBedrockError {
+    name = "ValidationException";
+    constructor(message) {
+        super(message, { httpStatusCode: 400 });
+    }
+}
+/**
+ * Simulated Bedrock error for a response declared against this simulation that
+ * it cannot answer with.
+ *
+ * This is a simulator configuration error rather than an AWS one. A content
+ * block naming two kinds of content at once is refused where the declaration
+ * was written. A declaration carrying nothing the operation asking for it can
+ * use is refused where the call is made, since which operation reaches a rule
+ * is only known then.
+ */
+export class SimBedrockDeclarationError extends SimBedrockError {
+    name = "SimBedrockDeclarationError";
+}
+//# sourceMappingURL=sim-bedrock.error.js.map

package/dist/service/bedrock/error/sim-bedrock.error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-bedrock.error.js","sourceRoot":"","sources":["../../../../src/service/bedrock/error/sim-bedrock.error.ts"],"names":[],"mappings":"AAOA;;GAEG;AACH,MAAM,OAAO,eAAgB,SAAQ,KAAK;IAGtB,SAAS;IAF3B,YACE,OAAe,EACC,SAAS,GAA4B,EAAE;QAEvD,KAAK,CAAC,OAAO,CAAC,CAAC;yBAFC,SAAS;IAG3B,CAAC;CACF;AAED;;;;;;GAMG;AACH,MAAM,OAAO,6BAA8B,SAAQ,eAAe;IACvC,IAAI,GAAG,qBAAqB,CAAC;IAEtD,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,EAAE,EAAE,cAAc,EAAE,GAAG,EAAE,CAAC,CAAC;IAC1C,CAAC;CACF;AAED;;;;;;GAMG;AACH,MAAM,OAAO,+BAAgC,SAAQ,eAAe;IACzC,IAAI,GAAG,uBAAuB,CAAC;IAExD,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,EAAE,EAAE,cAAc,EAAE,GAAG,EAAE,CAAC,CAAC;IAC1C,CAAC;CACF;AAED;;;;;;;;;GASG;AACH,MAAM,OAAO,mCAAoC,SAAQ,eAAe;IAC7C,IAAI,GAAG,qBAAqB,CAAC;IAEtD,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,EAAE,EAAE,cAAc,EAAE,GAAG,EAAE,CAAC,CAAC;IAC1C,CAAC;CACF;AAED;;;;;;;;;GASG;AACH,MAAM,OAAO,0BAA2B,SAAQ,eAAe;IACpC,IAAI,GAAG,4BAA4B,CAAC;CAC9D"}

package/dist/service/bedrock/index.d.ts

@@ -0,0 +1,12 @@
+export { SimBedrock } from "./sim-bedrock.js";
+export type { SimBedrockRequestOptions } from "./command/sim-bedrock-request-options.js";
+export type { SimBedrockContentBlockDelta, SimBedrockContentBlockDeltaEvent, SimBedrockContentBlockStartEvent, SimBedrockContentBlockStopEvent, SimBedrockMessageStartEvent, SimBedrockMessageStopEvent, SimBedrockStreamMetadataEvent, SimConverseStreamOutput, } from "./command/converse/converse-stream.command.js";
+export type { SimInvokeModelResponseStreamOutput } from "./command/invoke-model/invoke-model.command.js";
+export type { SimBedrockStreamedBlock, SimBedrockStreamedTextBlock, SimBedrockStreamedToolUseBlock, } from "./response/sim-bedrock-streamed-content.js";
+export { SimBedrockResponses, type SimBedrockResponseRequest, } from "./response/sim-bedrock-responses.js";
+export type { SimBedrockDeclaredContentBlock, SimBedrockDeclaredResponse, SimBedrockDeclaredToolUse, SimBedrockDeclaredUsage, } from "./response/sim-bedrock-response-declaration.js";
+export { simBedrockDefaultInputTokens, simBedrockDefaultOutputTokens, simBedrockDefaultResponse, simBedrockDefaultStopReason, simBedrockDefaultText, } from "./response/sim-bedrock-response-defaults.js";
+export type { SimBedrockResponseUsage } from "./response/sim-bedrock-declared-usage.js";
+export { SimBedrockResolvedResponse, type SimBedrockResponseMessage, } from "./response/sim-bedrock-resolved-response.js";
+export { SimBedrockAccessDeniedException, SimBedrockDeclarationError, SimBedrockError, SimBedrockUnsimulatedInputException, SimBedrockValidationException, } from "./error/sim-bedrock.error.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/service/bedrock/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/service/bedrock/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,YAAY,EAAE,wBAAwB,EAAE,MAAM,0CAA0C,CAAC;AACzF,YAAY,EACV,2BAA2B,EAC3B,gCAAgC,EAChC,gCAAgC,EAChC,+BAA+B,EAC/B,2BAA2B,EAC3B,0BAA0B,EAC1B,6BAA6B,EAC7B,uBAAuB,GACxB,MAAM,+CAA+C,CAAC;AACvD,YAAY,EAAE,kCAAkC,EAAE,MAAM,gDAAgD,CAAC;AACzG,YAAY,EACV,uBAAuB,EACvB,2BAA2B,EAC3B,8BAA8B,GAC/B,MAAM,4CAA4C,CAAC;AACpD,OAAO,EACL,mBAAmB,EACnB,KAAK,yBAAyB,GAC/B,MAAM,qCAAqC,CAAC;AAC7C,YAAY,EACV,8BAA8B,EAC9B,0BAA0B,EAC1B,yBAAyB,EACzB,uBAAuB,GACxB,MAAM,gDAAgD,CAAC;AACxD,OAAO,EACL,4BAA4B,EAC5B,6BAA6B,EAC7B,yBAAyB,EACzB,2BAA2B,EAC3B,qBAAqB,GACtB,MAAM,6CAA6C,CAAC;AACrD,YAAY,EAAE,uBAAuB,EAAE,MAAM,0CAA0C,CAAC;AACxF,OAAO,EACL,0BAA0B,EAC1B,KAAK,yBAAyB,GAC/B,MAAM,6CAA6C,CAAC;AACrD,OAAO,EACL,+BAA+B,EAC/B,0BAA0B,EAC1B,eAAe,EACf,mCAAmC,EACnC,6BAA6B,GAC9B,MAAM,8BAA8B,CAAC"}

package/dist/service/bedrock/index.js

@@ -0,0 +1,6 @@
+export { SimBedrock } from "./sim-bedrock.js";
+export { SimBedrockResponses, } from "./response/sim-bedrock-responses.js";
+export { simBedrockDefaultInputTokens, simBedrockDefaultOutputTokens, simBedrockDefaultResponse, simBedrockDefaultStopReason, simBedrockDefaultText, } from "./response/sim-bedrock-response-defaults.js";
+export { SimBedrockResolvedResponse, } from "./response/sim-bedrock-resolved-response.js";
+export { SimBedrockAccessDeniedException, SimBedrockDeclarationError, SimBedrockError, SimBedrockUnsimulatedInputException, SimBedrockValidationException, } from "./error/sim-bedrock.error.js";
+//# sourceMappingURL=index.js.map

package/dist/service/bedrock/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/service/bedrock/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAkB9C,OAAO,EACL,mBAAmB,GAEpB,MAAM,qCAAqC,CAAC;AAO7C,OAAO,EACL,4BAA4B,EAC5B,6BAA6B,EAC7B,yBAAyB,EACzB,2BAA2B,EAC3B,qBAAqB,GACtB,MAAM,6CAA6C,CAAC;AAErD,OAAO,EACL,0BAA0B,GAE3B,MAAM,6CAA6C,CAAC;AACrD,OAAO,EACL,+BAA+B,EAC/B,0BAA0B,EAC1B,eAAe,EACf,mCAAmC,EACnC,6BAA6B,GAC9B,MAAM,8BAA8B,CAAC"}

package/dist/service/bedrock/model/sim-bedrock-model-arn.d.ts

@@ -0,0 +1,12 @@
+import type { SimAwsAccountRegionScope } from "../../aws/sim-aws-account-region-scope.js";
+/**
+ * The ARN a request authorizes against for the model it names.
+ *
+ * A `modelId` reaches Bedrock in several forms. A base model id such as
+ * `anthropic.claude-3-5-sonnet-20241022-v2:0` names a foundation model, which
+ * belongs to no account and carries an empty account field in its ARN. An
+ * inference profile, a provisioned model and a prompt version all arrive as
+ * ARNs already, and are authorized against as they were written.
+ */
+export declare function simBedrockModelArn(accountRegionScope: SimAwsAccountRegionScope, modelId: string): string;
+//# sourceMappingURL=sim-bedrock-model-arn.d.ts.map

package/dist/service/bedrock/model/sim-bedrock-model-arn.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-bedrock-model-arn.d.ts","sourceRoot":"","sources":["../../../../src/service/bedrock/model/sim-bedrock-model-arn.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,2CAA2C,CAAC;AAE1F;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAChC,kBAAkB,EAAE,wBAAwB,EAC5C,OAAO,EAAE,MAAM,GACd,MAAM,CAMR"}

package/dist/service/bedrock/model/sim-bedrock-model-arn.js

@@ -0,0 +1,16 @@
+/**
+ * The ARN a request authorizes against for the model it names.
+ *
+ * A `modelId` reaches Bedrock in several forms. A base model id such as
+ * `anthropic.claude-3-5-sonnet-20241022-v2:0` names a foundation model, which
+ * belongs to no account and carries an empty account field in its ARN. An
+ * inference profile, a provisioned model and a prompt version all arrive as
+ * ARNs already, and are authorized against as they were written.
+ */
+export function simBedrockModelArn(accountRegionScope, modelId) {
+    if (modelId.startsWith("arn:")) {
+        return modelId;
+    }
+    return `arn:aws:bedrock:${accountRegionScope.regionName}::foundation-model/${modelId}`;
+}
+//# sourceMappingURL=sim-bedrock-model-arn.js.map

package/dist/service/bedrock/model/sim-bedrock-model-arn.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-bedrock-model-arn.js","sourceRoot":"","sources":["../../../../src/service/bedrock/model/sim-bedrock-model-arn.ts"],"names":[],"mappings":"AAEA;;;;;;;;GAQG;AACH,MAAM,UAAU,kBAAkB,CAChC,kBAA4C,EAC5C,OAAe;IAEf,IAAI,OAAO,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;QAC/B,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,OAAO,mBAAmB,kBAAkB,CAAC,UAAU,sBAAsB,OAAO,EAAE,CAAC;AACzF,CAAC"}

package/dist/service/bedrock/response/sim-bedrock-declared-content.d.ts

@@ -0,0 +1,15 @@
+import type { SimBedrockDeclaredContentBlock, SimBedrockDeclaredResponse } from "./sim-bedrock-response-declaration.js";
+/**
+ * The content blocks a declared response answers `Converse` with.
+ *
+ * A response declared as chunks holds them joined, so the same declaration
+ * answers `Converse` with the whole text and `ConverseStream` with the deltas
+ * it was written in.
+ *
+ * A response declared as a body alone has no content, which is the ordinary
+ * case rather than an error: it answers `InvokeModel`. A response with no
+ * content and no body has nothing to answer anything with, and is refused
+ * where it was written.
+ */
+export declare function simBedrockDeclaredContent(subject: string, declared: SimBedrockDeclaredResponse): readonly SimBedrockDeclaredContentBlock[] | undefined;
+//# sourceMappingURL=sim-bedrock-declared-content.d.ts.map

package/dist/service/bedrock/response/sim-bedrock-declared-content.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-bedrock-declared-content.d.ts","sourceRoot":"","sources":["../../../../src/service/bedrock/response/sim-bedrock-declared-content.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,8BAA8B,EAC9B,0BAA0B,EAC3B,MAAM,uCAAuC,CAAC;AAqF/C;;;;;;;;;;;GAWG;AACH,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,0BAA0B,GACnC,SAAS,8BAA8B,EAAE,GAAG,SAAS,CAYvD"}

package/dist/service/bedrock/response/sim-bedrock-declared-content.js

@@ -0,0 +1,73 @@
+import { SimBedrockDeclarationError } from "../error/sim-bedrock.error.js";
+function checkedBlock(subject, block) {
+    const { text, toolUse } = block;
+    if (text !== undefined && toolUse !== undefined) {
+        throw new SimBedrockDeclarationError(`A content block declared for ${subject} carries both text and a tool ` +
+            `use. A block is one or the other, as it is on real Bedrock.`);
+    }
+    if (text === undefined && toolUse === undefined) {
+        throw new SimBedrockDeclarationError(`A content block declared for ${subject} carries neither text nor a ` +
+            `tool use, and there is nothing for a response to answer with.`);
+    }
+    return block;
+}
+/**
+ * The members a response used to say what the message holds.
+ *
+ * One response says it one way. `text` is a single block, `chunks` is that
+ * block written as the deltas a stream sends, and `content` is the blocks
+ * themselves.
+ */
+function namedMessageMembers(declared) {
+    const named = [];
+    if (declared.text !== undefined) {
+        named.push("text");
+    }
+    if (declared.chunks !== undefined) {
+        named.push("chunks");
+    }
+    if (declared.content !== undefined) {
+        named.push("content");
+    }
+    return named;
+}
+function requireOneMessageMember(subject, declared) {
+    const named = namedMessageMembers(declared);
+    if (named.length > 1) {
+        throw new SimBedrockDeclarationError(`The response declared for ${subject} carries ${named.join(" and ")}. ` +
+            `Each of those says what the message holds, so declare one of them.`);
+    }
+}
+function blocksOf(subject, declared) {
+    const { text, chunks, content } = declared;
+    requireOneMessageMember(subject, declared);
+    if (text !== undefined) {
+        return [{ text }];
+    }
+    if (chunks !== undefined) {
+        return [{ text: chunks.join("") }];
+    }
+    return content?.map((block) => checkedBlock(subject, block));
+}
+/**
+ * The content blocks a declared response answers `Converse` with.
+ *
+ * A response declared as chunks holds them joined, so the same declaration
+ * answers `Converse` with the whole text and `ConverseStream` with the deltas
+ * it was written in.
+ *
+ * A response declared as a body alone has no content, which is the ordinary
+ * case rather than an error: it answers `InvokeModel`. A response with no
+ * content and no body has nothing to answer anything with, and is refused
+ * where it was written.
+ */
+export function simBedrockDeclaredContent(subject, declared) {
+    const blocks = blocksOf(subject, declared);
+    if (blocks === undefined && declared.body === undefined) {
+        throw new SimBedrockDeclarationError(`The response declared for ${subject} carries no text, no content and ` +
+            `no body. Declare text, chunks or content for Converse, or a body ` +
+            `for InvokeModel.`);
+    }
+    return blocks;
+}
+//# sourceMappingURL=sim-bedrock-declared-content.js.map

package/dist/service/bedrock/response/sim-bedrock-declared-content.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-bedrock-declared-content.js","sourceRoot":"","sources":["../../../../src/service/bedrock/response/sim-bedrock-declared-content.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,0BAA0B,EAAE,MAAM,+BAA+B,CAAC;AAM3E,SAAS,YAAY,CACnB,OAAe,EACf,KAAqC;IAErC,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,KAAK,CAAC;IAEhC,IAAI,IAAI,KAAK,SAAS,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;QAChD,MAAM,IAAI,0BAA0B,CAClC,gCAAgC,OAAO,gCAAgC;YACrE,6DAA6D,CAChE,CAAC;IACJ,CAAC;IAED,IAAI,IAAI,KAAK,SAAS,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;QAChD,MAAM,IAAI,0BAA0B,CAClC,gCAAgC,OAAO,8BAA8B;YACnE,+DAA+D,CAClE,CAAC;IACJ,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;;;GAMG;AACH,SAAS,mBAAmB,CAC1B,QAAoC;IAEpC,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,IAAI,QAAQ,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;QAChC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACrB,CAAC;IAED,IAAI,QAAQ,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;QAClC,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACvB,CAAC;IAED,IAAI,QAAQ,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;QACnC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IACxB,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,uBAAuB,CAC9B,OAAe,EACf,QAAoC;IAEpC,MAAM,KAAK,GAAG,mBAAmB,CAAC,QAAQ,CAAC,CAAC;IAE5C,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACrB,MAAM,IAAI,0BAA0B,CAClC,6BAA6B,OAAO,YAAY,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI;YACrE,oEAAoE,CACvE,CAAC;IACJ,CAAC;AACH,CAAC;AAED,SAAS,QAAQ,CACf,OAAe,EACf,QAAoC;IAEpC,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,QAAQ,CAAC;IAE3C,uBAAuB,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IAE3C,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;QACvB,OAAO,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC;IACpB,CAAC;IAED,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QACzB,OAAO,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;IACrC,CAAC;IAED,OAAO,OAAO,EAAE,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,YAAY,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC;AAC/D,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,yBAAyB,CACvC,OAAe,EACf,QAAoC;IAEpC,MAAM,MAAM,GAAG,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IAE3C,IAAI,MAAM,KAAK,SAAS,IAAI,QAAQ,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;QACxD,MAAM,IAAI,0BAA0B,CAClC,6BAA6B,OAAO,mCAAmC;YACrE,mEAAmE;YACnE,kBAAkB,CACrB,CAAC;IACJ,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/service/bedrock/response/sim-bedrock-declared-usage.d.ts

@@ -0,0 +1,19 @@
+import type { SimBedrockDeclaredResponse } from "./sim-bedrock-response-declaration.js";
+/**
+ * The token counts one response reports.
+ */
+export interface SimBedrockResponseUsage {
+    readonly inputTokens: number;
+    readonly outputTokens: number;
+    readonly totalTokens: number;
+}
+/**
+ * The token counts a declared response reports, with the built-in figures
+ * standing in for the ones it left out.
+ *
+ * Counting the tokens in a prompt needs the tokenizer of the model the request
+ * names, and simulated Bedrock runs no model. A test asserting on a count
+ * declares one.
+ */
+export declare function simBedrockDeclaredUsage(subject: string, declared: SimBedrockDeclaredResponse): SimBedrockResponseUsage;
+//# sourceMappingURL=sim-bedrock-declared-usage.d.ts.map

package/dist/service/bedrock/response/sim-bedrock-declared-usage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-bedrock-declared-usage.d.ts","sourceRoot":"","sources":["../../../../src/service/bedrock/response/sim-bedrock-declared-usage.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,uCAAuC,CAAC;AAMxF;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AAsBD;;;;;;;GAOG;AACH,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,0BAA0B,GACnC,uBAAuB,CAoBzB"}

package/dist/service/bedrock/response/sim-bedrock-declared-usage.js

@@ -0,0 +1,31 @@
+import { SimBedrockDeclarationError } from "../error/sim-bedrock.error.js";
+import { simBedrockDefaultInputTokens, simBedrockDefaultOutputTokens, } from "./sim-bedrock-response-defaults.js";
+function countOf(subject, name, count, fallback) {
+    if (count === undefined) {
+        return fallback;
+    }
+    if (!Number.isSafeInteger(count) || count < 0) {
+        throw new SimBedrockDeclarationError(`The response declared for ${subject} reports ${count} ${name}. A ` +
+            `token count is a whole number of tokens and never negative.`);
+    }
+    return count;
+}
+/**
+ * The token counts a declared response reports, with the built-in figures
+ * standing in for the ones it left out.
+ *
+ * Counting the tokens in a prompt needs the tokenizer of the model the request
+ * names, and simulated Bedrock runs no model. A test asserting on a count
+ * declares one.
+ */
+export function simBedrockDeclaredUsage(subject, declared) {
+    const { usage } = declared;
+    const inputTokens = countOf(subject, "input tokens", usage?.inputTokens, simBedrockDefaultInputTokens);
+    const outputTokens = countOf(subject, "output tokens", usage?.outputTokens, simBedrockDefaultOutputTokens);
+    return {
+        inputTokens,
+        outputTokens,
+        totalTokens: inputTokens + outputTokens,
+    };
+}
+//# sourceMappingURL=sim-bedrock-declared-usage.js.map

package/dist/service/bedrock/response/sim-bedrock-declared-usage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-bedrock-declared-usage.js","sourceRoot":"","sources":["../../../../src/service/bedrock/response/sim-bedrock-declared-usage.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,0BAA0B,EAAE,MAAM,+BAA+B,CAAC;AAE3E,OAAO,EACL,4BAA4B,EAC5B,6BAA6B,GAC9B,MAAM,oCAAoC,CAAC;AAW5C,SAAS,OAAO,CACd,OAAe,EACf,IAAY,EACZ,KAAyB,EACzB,QAAgB;IAEhB,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACxB,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;QAC9C,MAAM,IAAI,0BAA0B,CAClC,6BAA6B,OAAO,YAAY,KAAK,IAAI,IAAI,MAAM;YACjE,6DAA6D,CAChE,CAAC;IACJ,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,uBAAuB,CACrC,OAAe,EACf,QAAoC;IAEpC,MAAM,EAAE,KAAK,EAAE,GAAG,QAAQ,CAAC;IAC3B,MAAM,WAAW,GAAG,OAAO,CACzB,OAAO,EACP,cAAc,EACd,KAAK,EAAE,WAAW,EAClB,4BAA4B,CAC7B,CAAC;IACF,MAAM,YAAY,GAAG,OAAO,CAC1B,OAAO,EACP,eAAe,EACf,KAAK,EAAE,YAAY,EACnB,6BAA6B,CAC9B,CAAC;IAEF,OAAO;QACL,WAAW;QACX,YAAY;QACZ,WAAW,EAAE,WAAW,GAAG,YAAY;KACxC,CAAC;AACJ,CAAC"}

package/dist/service/bedrock/response/sim-bedrock-resolved-response.d.ts

@@ -0,0 +1,54 @@
+import { type SimBedrockResponseUsage } from "./sim-bedrock-declared-usage.js";
+import type { SimBedrockDeclaredContentBlock, SimBedrockDeclaredResponse } from "./sim-bedrock-response-declaration.js";
+import { type SimBedrockStreamedBlock } from "./sim-bedrock-streamed-content.js";
+/**
+ * The message one `Converse` call answers with.
+ */
+export interface SimBedrockResponseMessage {
+    readonly role: "assistant";
+    readonly content: readonly SimBedrockDeclaredContentBlock[];
+}
+/**
+ * One declared response, resolved from its declaration.
+ *
+ * The declaration is resolved when the rule is registered, so a content block
+ * carrying two kinds of content at once, or a negative token count, is refused
+ * where it was written. What the response can answer is resolved per call,
+ * because which operation reaches a rule is only known then.
+ */
+export declare class SimBedrockResolvedResponse {
+    private readonly subject;
+    private readonly declared;
+    private readonly declaredUsage;
+    private readonly content;
+    constructor(subject: string, declared: SimBedrockDeclaredResponse);
+    /**
+     * The message a `Converse` call answers with.
+     *
+     * A response declared for `InvokeModel` alone has no message, and reaching
+     * it from `Converse` is a declaration this simulation cannot answer with.
+     */
+    message(): SimBedrockResponseMessage;
+    /**
+     * How the message arrives over `ConverseStream`, block by block.
+     */
+    streamedContent(): readonly SimBedrockStreamedBlock[];
+    /**
+     * The body an `InvokeModel` call answers with, before it is serialized.
+     */
+    body(): unknown;
+    /**
+     * Why the model stopped generating.
+     *
+     * A response holding a tool use stops for that, as a real one does, unless
+     * the declaration named a reason of its own.
+     */
+    stopReason(): string;
+    /**
+     * The token counts the response reports.
+     */
+    usage(): SimBedrockResponseUsage;
+    private requireContent;
+    private reachedStopReason;
+}
+//# sourceMappingURL=sim-bedrock-resolved-response.d.ts.map

package/dist/service/bedrock/response/sim-bedrock-resolved-response.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-bedrock-resolved-response.d.ts","sourceRoot":"","sources":["../../../../src/service/bedrock/response/sim-bedrock-resolved-response.ts"],"names":[],"mappings":"AAEA,OAAO,EAEL,KAAK,uBAAuB,EAC7B,MAAM,iCAAiC,CAAC;AACzC,OAAO,KAAK,EACV,8BAA8B,EAC9B,0BAA0B,EAC3B,MAAM,uCAAuC,CAAC;AAE/C,OAAO,EAEL,KAAK,uBAAuB,EAC7B,MAAM,mCAAmC,CAAC;AAE3C;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,SAAS,8BAA8B,EAAE,CAAC;CAC7D;AAID;;;;;;;GAOG;AACH,qBAAa,0BAA0B;IACrC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA6B;IACtD,OAAO,CAAC,QAAQ,CAAC,aAAa,CAA0B;IACxD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAEV;IAEd,YAAY,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,0BAA0B,EAKhE;IAED;;;;;OAKG;IACH,OAAO,IAAI,yBAAyB,CAEnC;IAED;;OAEG;IACH,eAAe,IAAI,SAAS,uBAAuB,EAAE,CAEpD;IAED;;OAEG;IACH,IAAI,IAAI,OAAO,CAWd;IAED;;;;;OAKG;IACH,UAAU,IAAI,MAAM,CAEnB;IAED;;OAEG;IACH,KAAK,IAAI,uBAAuB,CAE/B;IAED,OAAO,CAAC,cAAc;IAYtB,OAAO,CAAC,iBAAiB;CAM1B"}